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This publication describes the functional capabilities and the operation of the "IBM 
7171 ASCII Device Attachment Control Unit," referred to in this publication as 
the "IBM 7171." The publication is intended for system programmers and opera- 
tion personnel, but also contains useful information for terminal users. The fol- 
lowing is an overview of the contents of the publication: 

Chapter 1. Introduction to the IBM 7171 - Gives general overview and uses of the 
system. 

Chapter 2. System Description and Operation - Defines the main components and 
their functions. Describes the setup requirements and system opera- 
tion. 

Chapter 3. Using ASCII Terminals on the IBM 7171 - Describes the system func- 
tions that are available for various terminal types. 

Chapter 4. Customizing IBM 7171 Tables - Describes how to modify supplied Ter- 
minal Definition Tables and generate new ones for new terminal types. 
Explains how to modify the predefined configuration parameters for 
each port address. 

Chapter 5. IBM 7171 I/O Interface to Terminals - Describes the Terminal Con- 
troller I/O interface protocol to devices attached via RS-232-C lines. 

Chapter 6. IBM 7171 I/O Interface to the Host System - Describes the Channel 
Controller interface protocol to the host computer channel. 

Chapter 7. IBM 7171 Diagnostics - Describes the Diagnostics operation. 

Chapter 8. Problem Determination - Explains how to handle problems that may 
occur during operation. 

Chapter 9. Special Maintenance Facility and System Messages - Explains how to use 
the special Maintenance Facility. Defines all of the IBM 7171 system 
messages. 

Appendix A. ASCII and EBCDIC Data Conversion Tables - Defines the data con- 
version tables. 

Appendix B. IBM 7171 Supplied Terminal Definition Tables - Defines the Terminal 
Definition Tables supplied with the system and describes the functions 
of specific terminals. 
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Appendix C. IBM 7171 Support Utility for Modifying Terminal Tables - Describes 
how to use a supplied utility that runs on the IBM Personal Computer 
that may be used to modify Terminal Definition Tables. 

| Appendix D. Interface for User Supplied Table Modification Program - Describes 

| how to add a user supplied program for customizing the IBM 7171 

| Terminal Definition Tables. 

| Appendix E. ROM Data Base Organization - Describes the organization of Read- 

| Only Memory and the contents of the various tables. 

The reader is expected to be f amiliar with either the IBM host VM or MVS con- 
cepts and terminology. Helpful references are listed in "Related Publications." 
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Chapter 1. Introduction to the IBM 7171 



1.1 Overview 



The IBM 7171 ASCII Device Attachment Control Unit (IBM 7171) provides the 
ability to attach a variety of full duplex ASCII devices directly to IBM 43xx, 308x, 
or 3090 host processors via a block multiplexer channel. Attachment of up to 64 
ASCII devices is supported via the RS-232-C electrical interfaces at speeds of 50 
to 19,200 bits per second. This baud rate is limited only by the facilities of the 
communication link and the ASCII device. Automatic baud rate recognition 
(autobaud) is available on a per line basis for 300, 600, 1200, 1800, 2400, 3600, 
4800, 9600 and 19200 baud. 

These devices may be connected directly to the IBM 7171 without modems, or via 
leased or switched lines using line drivers, modems or acoustic couplers. 

The IBM 7171 also provides ASCII to IBM 3270 protocol conversion. The IBM 
7171 appears to the host processor as one or two IBM 3274 model ID control 
units. The attached ASCII display terminals and printers appear to the host system 
as IBM 3278 or 3277 terminals and IBM 3286 printers. 

IBM 3270 emulation allows the IBM 7171 attached devices to communicate with 
IBM interactive packages while utilizing existing 3270 programs with no host mod- 
ification required. 

IBM 3270 emulation extends the capabilities of the ASCII device by providing 
3270 type functions. These functions include: program function keys, program 
attention keys, light pen simulation, numeric-only input fields, highlighting, pro- 
tected field skip, unformatted screens and editing functions such as, character 
insert and delete, forward and backward field tabs, erase to end of field, clear 
screen and cursor movements. 

In addition to 3270 emulation, extended functions have also been included. These 
functions include: type-ahead capability, enhanced null/blank handling, 
XON/XOFF pacing, dynamically redefinable home position, special indentation 
features, and forward and backward column tabbing. 

The IBM 7171 is designed for easy customer installation, setup and maintenance. It 
can be integrated into an established communication network or it can be the 
keystone for a newly designed network. 
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1.2 ASCII Device Support 



The IBM 7171 allows attachment of a wide variety of ASCII devices. The 
minimum criteria for device attachment are listed in section 2.6.2, "ASCII Display 
Terminal Requirements" on page 2-11. 

Device characteristics are contained in Terminal Definition Tables. Default tables 
are shipped with the IBM 7171 to support several commonly used ASCII device 
types, including the IBM 3101. 

The customer may use existing tables to attach these common device types. He may 
also modify existing tables or create new tables to support attachment of other 
devices. This modification may be accomplished using the special Maintenance 
Facility of the IBM 7171 or using a support utility. The supplied Support Utility 
requires an IBM Personal Computer with the Personal Computer Disk Operating 
System Version 2.00 (or equivalent) and an Asynchronous Communications 
Adapter. 

Color terminals can be defined to emulate IBM 3279 "basic color." Basic color 
means that four different colors are assigned to protected/unprotected and 
highlighted/normal fields. Selection of color is table defined. 

A special 3270 type order sequence provides for transparent input and output to 
ASCII devices which cannot easily simulate a 3270 type device. 
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1.3 New Features In This Release 



The IBM 7171 has many new features. These include: 

• File Transfer Support is provided, including an improved Transparent 
Write/Read algorithm and pacing implementation. There are however, 
intrinsic performance limitations when files are transferred. If simultaneous 
data transfers are attempted to or from ASCII devices which do NOT require 
'user reaction' time (such as printers or Personal Computer file transfers), then 
there may be a noticeable delay in processing. When an IBM 7171 installation 
intends to include such devices, then the IBM 7171 should be tested by the 
customer to determine if the performance will be satisfactory in the proposed 
system configuration. To support file transfer, packet sizes of 256 bytes 
(including packet header and trailer controls) will now be accepted from all 
devices at rates up to 19,200 bps, regardless of pacing support. The packets 
must be built by a suitable user-provided protocol between the host processor 
and the ASCII device. Transparent mode operation has also changed. For 
details on these changes, refer to 6.4.3, "Special Order Strings" on page 6-38. 

• Pacing - The IBM 7171 previously honored pacing characters sent to it by a 
device only when the device input buffer became close to full. The IBM 7171 
now supports sending pacing characters to the device when the IBM 7171 
input buffers are close to full, if pacing is enabled and the Terminal Definition 
Table (TDT) for the device contains the pacing characters. For more informa- 
tion, see 5.8, "Pacing" on page 5-8. 

• Ignore Parity - The 7171 has added a feature to ignore input parity, and to gen- 
erate any desired parity on output. This can be done on either a per port or 
per control unit basis. For more information, see 4.4.1, "Data Area 1 Layout" 
on page 4-20 and 4.4.2, "Ports Area Layout" on page 4-21. 

• 3270 Alternate Screen Size Support has been added. To accomplish this, a new 
Terminal Definition Table (TDT) format has been defined. The older version 
TDT will still function in this release, and in fact all of the default tables within 
the IBM 7171 are still of this format. However, if new tables are created from 
the defaults using the supplied IBM 7171 Support Utility (Version 2.0 or later), 
they will be defined in the new format. 

Note: 

Version 2.0 (or later) of the IBM 7171 Support Utility, should only be used 
when EC A3 1860 is installed. It may be necessary to re-link the image file and 
recreate port definitions as well. 

For a description of how alternate screen sizes are supported on the IBM 7171, 
see 3.1.1, "3270 Alternate Screen Size Support" on page 3-1. The new TDT 
is completely defined in Chapter 4, "Customizing IBM 7171 Tables" on 
page 4-1. For a description of how alternate screen sizes operate from a host 
standpoint, refer to "Erase/Write Alternate Command" on page 6-7. 

• New Terminal Types - Support is provided for the IBM 3 161 and 3 163 ASCII 
terminals in native mode using the IBM316X terminal type. The ROLM Cor- 
poration desktop products Cypress, Cedar, and Juniper are also supported 
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using the ROLM3270 terminal type. For more information, see 
B.l, "Functions of Specific ASCII Terminals" on page B-l. 

3286 Emulation - The default HARDCOPY terminal type has been changed to 
make it possible to define an ASCII printer device as a 3286 printer. Most 
applications that are written for a 3286 should now be able to use this defi- 
nition with no changes. For more information, see 6.3, "IBM 7171 Printer 
Support" on page 6-23 for details. 

Rubout, Mult keys - Two new input key sequences have been defined. The 
Rubout key sequence functions as a destructive backspace. The Mult key 
sequence allows any graphic character to be entered in the ASCII screen 
image. For more information, see 4.5.2, "Function Name Table" on 
page 4-40. 
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Chapter 2. System Description and Operation 



This chapter gives an overview of the functions of the IBM 7171. It describes the 
setup requirements and system operation. This chapter is organized as follows: 

The IBM 7171 components and functions 

The ASCII devices supported, including display terminals, typewriter terminals, 
printers, and plotters 

Differences between ASCII and IBM 3270 devices 

Customizing the IBM 7171 

Operating environment of the IBM 7171 

Setup requirements for the IBM 7171 

System start-up and operation. 

Figure 2-1 shows a typical system configuration for the IBM 7171. 



2.1 Terminology 



To simplify references to functions that are generated by various keys or key 
sequences on different ASCII terminals, this publication generally refers to the 
name of the function rather than the key or key sequence used to generate it. For 
example, "pressing ENTER," or "pressing the ENTER key," should be understood 
to mean pressing the key, or key sequence, that would generate the Enter function 
on the specific terminal. 

On most ASCII terminals the RETURN key is used to generate the Enter function, 
but there are several other possibilities. For example, on the IBM 3101 the Enter 
function is generated by the backspace key: 
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On the IBM Personal Computer when running the IBM 3101 Emulation Program, 
the following key is used: 



And on the Tele Video Model 950, the user can generate the Enter function in 
three ways: by pressing RETURN, ENTER or the sequence CTRL 'm\ The 
relationships between the keys on the various ASCII terminals and the functions 
that they generate are explained in the tables contained in Appendix B, "IBM 
7171 Supplied Terminal Definition Tables." 
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Figure 2-1. System Configuration for IBM 7171 



2.2 The IBM 7171 ASCII Device Attachment Control Unit 

The IBM 7171 ASCII Device Attachment Control Unit supports a variety of 
ASCII terminals, printers and plotters. It provides a full duplex asynchronous 
ASCII terminal interface, with electrical connection via EIA RS-232-C. Flexible 
communications attachment options allow devices to be connected directly to the 
IBM 7171 without modems, or via leased and switched lines using line drivers, 
modems or acoustic couplers. Data rates may be from 50 to 19,200 bits per second, 
depending on the capabilities of the communication link and the terminal. Auto- 
matic baud recognition (autobaud) is selectable on a per-line basis for 300, 600, 
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1200, 1800, 2400, 3600, 4800, 9600 and 19200 baud upon receipt of a single car- 
riage return (CR) character. 

The host processor may be an IBM 43xx, 308x, or 3090 running a VM/SP or MVS 
operating system. The IBM 7171 attaches to the host via a block multiplexer 
channel and communicates with the host processor channel program. 

The IBM 7171 provides support for ASCII terminals, such as the IBM 3101, for 
use with interactive host applications running under VM/SP or MVS. It emulates a 
locally attached 3274- ID control unit with IBM 3270 terminals attached. It allows 
users of ASCII terminals to communicate with standard IBM host interactive pack- 
ages and editors operating under VM/SP or MVS. This emulation of 3270 termi- 
nals gives ASCII terminal users access to a wide range of host application programs 
with no host modifications required. 

In addition to full screen ASCII terminal support, a transparent interface is pro- 
vided which allows connection of devices that are not full screen by nature, such as 
printers and plotters. 



2.2.1 Hardware Components 



The main functional components of the IBM 7171 are the CPU board, the channel 
controller board, the channel adapter board and up to eight terminal controller 
boards. Figure 2-2 shows the interfaces between the hardware components. The 
channel adapter board interfaces with the host processor channel. Each terminal 
controller controls up to eight ASCII terminals. 

When the IBM 7171 power is turned on, microcoded diagnostics verify that the 
hardware system is operational. A description of the Diagnostics may be found in 
Chapter 7, "IBM 7171 Diagnostics." 
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Figure 2-2. Functional Hardware Components within the IBM 7171 
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2.2.2 Terminal Management 



Terminal management within the IBM 7171 for the emulated 3270 terminals is 
organized around a full screen image buffer, a ring buffer for keyboard input, a 
buffer for output to the terminal, and Terminal Definition Tables (TDT's) main- 
tained in IBM 7171 main memory for each ASCII terminal managed by the IBM 
7171 Control Microcode. 

The keyboard input routine interprets characters received from each ASCII ter- 
minal according to its associated Terminal Definition Table, and separates them 
into text, local editing function and "attention" functions. 

Text characters received from the terminal are entered directly into the screen 
buffer unless they would alter a protected field. In that case, the terminal's audible 
alarm sounds and the character is ignored. Local editing functions alter the screen 
buffer and/or cursor position buffer as appropriate. "Attention" generating func- 
tions are passed to the host and do not alter the screen buffer. 

The output process is invoked whenever changes are made to a terminal's screen 
image in IBM 7171 main memory by keyboard input or by output from a user's 
host application. The terminal screen is updated to match the screen image in IBM 
7171 main memory. 



2.2.3 Memory Organization of the CPU Board 



The main memory of the CPU board contains the Control Microcode and the sup- 
plied Terminal Definition Tables in Read-Only Memory (ROM). A part of 
memory in Non- Volatile RAM, referred to in this document as NV-RAM, is 
reserved for the user to add his own Terminal Definition Tables. The integrity of 
the contents of Non- Volatile RAM is maintained when the IBM 7171 power is off. 
The memory of the CPU board, which consists of ROM, NV-RAM, and RAM, is 
organized as shown below. 

ROM 

• IBM 7171 Control Microcode 

• Diagnostics 

• Supplied Terminal Definition Tables for several ASCII device types 

• EBCDIC/ASCII translation tables. 

Non-Volatile RAM (NV-RAM) 

• Pointers to Terminal Definition Tables (in ROM and NV-RAM) 

• Area reserved for user generated Terminal Definition Tables 

RAM 

• Screen images for up to 64 active terminals 

• Work area for IBM 7171 Control Microcode 

• Host and terminal input/output buffers. 
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2.2.4 Asynchronous Operation 



2.2.5 Error Recovery 



The terminal input, host input/output, and terminal output processes are coordi- 
nated, but operate asynchronously. Also, the user or the host application can gen- 
erate new screen images more quickly than the terminal is able to display them (for 
example, by rapid, consecutive page forward requests). The changes occur almost 
immediately in the screen buffer, but the output process is paced by the terminal 
line speed. Thus the user may see only the last version of the screen buffer and 
may not have to wait for all intermediate screens to be displayed. 



Recovery sequences are automatically initiated whenever a transmission or data 
error is detected. If a transmission error is detected on input data (incorrect parity, 
framing error or overrun), or when the input ring buffer is full, the terminal is 
marked in an input-error state. Once marked, every character received is ignored 
and the ASCII BEL character is sent to the terminal causing a "beep" that informs 
the terminal user of the error state. The terminal user can exit from this error situ- 
ation by typing in an appropriate reset key sequence. This error recovery sequence 
occurs transparently to the host application program. 

Should connection with the terminal be lost due to modem or phone line errors, the 
line is disabled and re-enabled to permit the user to dial back in and logon again. 
Error situations that a terminal user may encounter at his terminal are described in 
more detail in section 3.2, "Error Situations" on page 3-11. 



2.3 ASCII Devices Supported 



ASCII devices supported by the IBM 7171 include: 
ASCII terminals 

• display terminals 

• typewriter terminals. 

ASCII Output-only devices 

• printers and plotters running in transparent mode 

• printers emulating IBM 3286 printers 

• hardcopy devices connected to the auxiliary port of a display terminal. 

Display terminals with graphic capabilities can be supported by host applications. 

| For each IBM 7171 communication line, characteristic data including the line speed 

| (or autobaud detection), parity selection, number of stop bits, type of connection 

| and terminal type must be defined. (Terminal type and certain line speeds may be 

| left undefined thereby invoking autobaud and terminal type prompting.) For a 

complete definition and the default settings as delivered, refer to section 
4.4.2, "Ports Area Layout" on page 4-21. The procedure for changing these pre- 
defined parameters for each communication line is explained in 
Chapter 4, "Customizing IBM 7171 Tables." 
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2.3.1 ASCII Terminals 



ASCII Display Terminals 



Both IBM and non-IBM ASCII display terminals can be attached. All terminal 
dependent information is contained in Terminal Definition Tables, which can be 
customized by the user. Tables for the following terminals, or their equivalents, are 
provided: 

IBM 3101 (Models 1 or 2 in character mode) 

IBM Personal Computer 1 

Datamedia 1520/1521/3045 2 

DEC VT100 3 

LSI ADM 3 A/31 4 

TeleVideo 912/920/950 5 

IBM 3161 and IBM 3163 

ROLM Cypress, Cedar, and Juniper Desktop Products 6 . 

Hardcopy output of the current screen contents of terminals with local print capa- 
bility can be obtained on printers attached to an auxiliary device port. 

Basically, the attached ASCII display terminals appear to the host system as 
upper/lower case IBM 3278 or 3277 terminals attached to one or two IBM 
3274-1D control units. ASCII APL terminals are emulated as either a 3277 APL 
display station with the Data Analysis feature or a 3278 APL display station with 
the APL/Text feature. Refer to section 2.6.2, "ASCII Display Terminal 
Requirements" on page 2-11 for the minimum requirements for attached ASCII 
terminals. 

3270 Emulation: The IBM 7171 provides support for ASCII display terminals 
when used with interactive host applications running under VM/SP or MVS. As 
long as existing IBM access methods are used within VM/SP or MVS, the user 
need not be concerned with the details of the program interfaces to the IBM 7171. 
Figure 2-3 lists the 3270 features that the IBM 7171 emulates. 

Many host applications, such as VM/SP CMS, have formatted screens with spe- 
cific data entry areas. The screen image that the user sees on a 3270 is almost 
exactly what he would see on, for example, an IBM 3101 connected via the IBM 
7171. The operations that can be performed on the 3270 can also be performed on 
an ASCII terminal. 



The IBM Personal Computer when running the IBM 3101 Emulation Program uses the 
standard IBM3101 Terminal Definition Table. 

A product of Datamedia Corporation. 

A product of Digital Equipment Corporation. 

A product of Lear Siegler, Incorporated. 

A product of TeleVideo Systems, Incorporated. 

Products of the ROLM Corporation. 
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For the terminal user, the difference in using an emulated 3270 is minor, and will 
be noted where it is relevant. 

Extended Functions: The additional functions provided in the IBM 7171 make work 
easier for the ASCII terminal user and are described in detail in section 3.1, "IBM 
3270 Emulated and Extended Functions" on page 3-1 and in section 
6.4.3, "Special Order Strings" on page 6-38. 

Because of these extended functions, it is sometimes necessary to make explicit ref- 
erences to the differences between the IBM 7171 support and the real 3270. If the 
user is not already familiar with a 3270 terminal, he may refer to the IBM publica- 
tions VM/SP Terminal User's Guide, or OS/VS2 TSO Terminal User's Guide, 
which are listed under "Related Publications" on page iv. 
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Figure 2-3 (Part 1 of 2). 3270 Features Emulated by the IBM 7171 
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Figure 2-3 (Part 2 of 2). 3270 Features Emulated by the IBM 7171 



ASCII Typewriter Terminals 



Terminal Definition Tables 



The TYPETERM device type provides limited support of ASCII typewriter termi- 
nals. Application programs that write one line at a time to the screen from top to 
bottom before pausing for input will approximate "roll screen" mode on a type- 
writer terminal. However, if more than a screen of data is sent, the standard 
"MORE ..." message will not appear. In this case the typewriter will wait for the 
user to press an attention key (Enter, PA1, PA2) before typing the next screen, or 
until the host eventually advances to the next screen. When the terminal type is 
TYPETERM the last line that would appear on a display screen is not printed. 

Note: Application programs using the terminal type TYPETERM with the full for- 
matted screen and writing to random locations on the screen, will appear to the ter- 
minal user very awkward and difficult to follow. 



A wide range of ASCII terminals can be handled with the mapping of terminal keys 
(for example, editing functions and PF keys) specified in Terminal Definition 
Tables. 

These tables allow any explicit sequence of one or more keystrokes to be assigned 
to each of the editing, "attention," and extended functions. If, for example, the 
terminal has transmitting cursor movement keys, the codes they generate can be 
assigned to the cursor movement functions of the system. If the terminal has no PF 
keys, the "Escape" key sequence and a number key may be assigned to generate 
the functions. Variations in key placement and hardware capabilities can be used 
or ignored, depending on installation options. Two similar terminals can be made 
to function differently, and dissimilar terminals can be made to appear similar, 
depending on the tables that are used. 

All such terminal dependent information is contained in user definable tables. The 
system as delivered contains Terminal Definition Tables for all ASCII terminals 
listed in "ASCII Display Terminals" on page 2-6. If, however, the user has other 
brands of terminals, or he wants to re-define the mapping of terminal keys, he can 
define new terminal tables as described in Chapter 4, "Customizing IBM 7171 
Tables." 



During terminal initialization, if the system prompt to enter the terminal type 
appears, press ENTER and a list of the supported terminal types is displayed, 
display of supported terminal types also appears if an invalid terminal type is 
entered. 



This 
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2.3.2 ASCII Output-Only Devices 



Output-only devices such as printers and plotters may be used in various ways. 
Host applications can mix normal 3270 order strings with transparent mode output 
to the same display terminal for graphic output or attached (auxiliary) devices. 



Output-Only Devices and User-Written Output Programs 



The user can write his own host application program to output data to an ASCII 
output device using transparent mode. The host application can also mix normal 
3270 order strings and transparent mode output to the same terminal to drive CRT 
terminals with graphic capabilities. 



Transparent Mode Interface with Host Channel 



3286 Printer Emulation 



Auxiliary Printers 



A special 3270 order sequence is defined to support transparent output (ASCII 
data from the host to the device) to hardcopy ASCII devices such as printers and 
plotters. This is described in section 6.4.3, "Special Order Strings" on page 6-38. 



An ASCII printer attached to the IBM 7171 may be used to emulate a 3286 printer 
as described in section 6.3, "IBM 7171 Printer Support" on page 6-23. The host 
processor sysgen should assign the line as a 3286 printer. Within the IBM 7171, 
the HARDCOPY terminal type should be used for 3286 emulation. Only the 3270 
Data Stream format of printer control is supported. For further information on the 
3270 Data Stream format of printer control, refer to IBM 3270 Information 
Display System 32 74 Control Unit Description and Programmer's Guide, listed in 
"Related Publications" on page iv. 



Some ASCII display terminals allow an ASCII hardcopy device to be connected to 
the auxiliary printer port of the display terminal. This includes the IBM 3101 and 
the IBM Personal Computer running the IBM 3101 Emulation Program. Local 
printing is invoked by a key sequence issued from the terminal keyboard, which 
results in the contents of the screen being printed on the hardcopy device. 

Similar functions may be available with non-IBM display terminals or personal 
computers. 



2.4 Differences Between ASCII and IBM 3270 Devices 

Note the following differences between ASCII printers and display terminals and 
IBM 3270 devices (EBCDIC) : 

• ASCII Display Terminals - ASCII display terminals, when used with the IBM 
7171, are subject to the following restrictions: 

1 . The character in the lower right hand corner of the screen is normally not 
displayed. On most ASCII terminals, any attempt to write a character in 
this position causes the screen to scroll up one line. Everything displayed 
on the screen therefore appears one line higher than the IBM 7171 internal 
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buffer indicates it is displayed, and the results of input are difficult to 
predict. 

It is sometimes possible to suppress this scrolling, which is done on the 
IBM 3101 terminal with a Customer Setup Switch. When this is done on 
all terminals of this type, the Terminal Definition Table for the terminal 
type can be changed to set the X ' 0040 ' flag bit to enable display of this 
last character position on the screen. (See the FLAGS keyword in the TDT 
in Chapter 4, "Customizing IBM 7171 Tables"). 

2. The handling of nulls (X ' 00 ' characters) is somewhat different. On a 
standard 3270 terminal, the null character is suppressed for input from the 
terminal from a Read Modified command. The null character appears on 
the screen as a blank and may separate "two words" as the data is viewed 
by the user. If the null is suppressed on input the host reads "twowords" 
and the result is typically an error. The IBM 7171 reduces the possibility of 
error by translating imbedded nulls between words to blanks while contin- 
uing to suppress trailing nulls at the end of the field. This reduces the 
amount of data the host must process. To maintain consistency, the Delete 
key operates across lines in a multi-line field (where there is no attribute 
byte in either column 80 or column 1 of the next line). Applications which 
write multi-line fields with nulls and then read them back with Read Buffer 
would find that the arrangement of lines on the screen had been damaged 
by multi-line Delete. Correct operation of such applications can be 
restored by use of Zones Mode as described under 3.1.6, "Setup 
Functions" on page 3-3. The improved null processing function of the 
IBM 7171 is an option that may be deactivated by the user. 

3. The IBM 7171 supports features of the 3270 family as described in IBM 
programming and hardware manuals. It does not claim to emulate acci- 
dental hardware characteristics when a particular 3270 model is sent an 
incorrect data stream. In particular, it may be more restrictive than the real 
hardware in checking the validity of characters used to form buffer 
addresses, attribute bytes, or other control functions. 

4. All terminals must communicate in full-duplex character mode. The IBM 
7171 cannot support hardware features which are not available in this 
mode, such as highlighting on a 3101 Model 2x (in block mode). For more 
details on this subject, refer to Chapter 3, "Using ASCII Terminals on the 
IBM 7171." 

ASCII Printers - The results of including arbitrary bit combinations in files 
printed on ASCII printers cannot be predicted, since certain bit combinations 
may be interpreted as control characters. Thus, certain bit combinations can 
result in errors, especially in files containing machine programs of the VM/SP 
'TEXT' file type. Printing of these files should therefore be avoided. 
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2.5 Customizing the IBM 7171 



The IBM 7171 is ready to operate, provided its configuration fits the requirements 
of the user's installation. The following types of customization changes can be 
made: 

1 . Changing Communication Lines - For each IBM 7171 port address the line 
speed (or autobaud detection), parity selection, number of stop bits, terminal 
type, valid types list, and other parameters are predefined but may be changed. 
For a complete definition and the default settings as delivered, refer to section 
4.4.2, "Ports Area Layout" on page 4-21. The procedure for changing these 
predefined parameters for each communication line is explained in 

Chapter 4, "Customizing IBM 7171 Tables." 

2. Generating Terminal Definition Tables - Existing tables can be modified (cus- 
tomized) and new ones created for new terminal types. Detailed information 
on how to do this is contained in Chapter 4, "Customizing IBM 7171 
Tables." 



2.6 Operating Environment of the IBM 7171 



The IBM 7171 requires the following system configuration and programming 
support: 



2.6.1 System Configuration 



Host Processor: The IBM 7 17 1 will support IBM 43xx, 308x, or 3090 processors 
running VM/SP Release 3 or MVS Release 3.8. The IBM 7171 must be attached 
to the host via a block multiplexer (BMPX) channel. Several IBM 7171's can be 
attached to a single BMPX channel at the same time. However, this could affect 
the performance of the IBM 7171 depending on what other I/O devices are 
attached to the same channel. It is recommended that the IBM 7171 not be put on 
the same channel as tape drives for performance reasons. 

Up to 64 ASCII devices may be attached to a single IBM 7171. When more than 
32 devices are attached, the IBM 7171 appears as two 3 274- ID control units. 



2.6.2 ASCII Display Terminal Requirements 



To be attached to the IBM 7171, ASCII display terminals must meet the following 
minimum functional requirements. The ASCII display terminal must be capable of 
full duplex character mode operation, must be connected point to point, must use 
the Start/Stop control protocol, and must use 7 bit ASCII code. The terminal must 
perform the following functions upon receiving an appropriate character sequence 
from the control unit: 

• Clear screen or clear to end-of-screen. 

• Absolute cursor positioning. 

• A character written to the screen should replace, not overstrike, the previous 
character in that position. APL mode is an exception, when overstrike charac- 
ters must be formed. 
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In addition, the following display terminal features are desirable, and can be used if 
they are present: 

Transmitting cursor movement keys 

Transmitting program function keys 

Audible alarm ("beep") 

Controllable indicator to signal "insert" mode 

Erase to end-of-line (required for APL terminals). 



2.7 Setup Requirements for the IBM 7171 



For planning and installation information refer to the IBM 71 71 ASCII Device 
Attachment Control Unit Description and Planning Guide listed in "Related 
Publications" on page iv. This reference gives site preparation and installation 
information including, connecting the host channel cables, setting the channel 
address of the IBM 7171, selecting the correct type of ASCII terminal cables, 
powering-up the IBM 7171, and trouble-shooting when the Ready indicator fails to 
light. 

Once the system has been installed, it can be adapted to the needs of the installa- 
tion as described earlier in section 2.5, "Customizing the IBM 7171" on 
page 2-11. 



Defining IBM 7171 and ASCII Terminals to the Host 



Each IBM 7171 must be defined to the host system as one or two 3274- ID control 
units. An IBM 7171 with support for 32 or less ports will appear as one 3274-1D. 
One with more than 32 ports will appear as two 3274- ID control units. 

The attached ASCII display terminals and printers appear to the host system as 
IBM 3278 or 3277 terminals and 3286 printers. Each IBM 7171 must define its 
attached display terminals as the same type, either IBM 3278 or 3277. 
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2.7.1 Preparing the VM/SP System 



An example of the necessary host entries for two IBM 7171's attached to the same 
host channel is shown in Figure 2-4. The first IBM 7171 has 64 ASCII devices 
attached and therefore requires entries to appear as two 3274 entries (two shared 
Unit Control Words). The second IBM 7171 has 32 ASCII devices attached and 
needs only one 3274 entry. 



* IBM 7171 SYSTEM 1 WITH 64 ASCII DEVICES 
RDEVICE ADDRESS=(c00,31) ,DEVTYPE=3278 ,MODEL=2 
RDEVICE ADDRESS=(c1F,01) ,DEVTYPE=3286 
RDEVICE ADDRESS=(c20,31) ,DEVTYPE=3278 ,MODEL=2 
RDEVICE ADDRESS=(c3F,01) ,DEVTYPE=3286 



* IBM 7171 
RDEVICE ADDRESS= 

* IBM 7171 
RCTLUNIT ADDRESS 
RCTLUNIT ADDRESS 
* 

* IBM 7171 
RCTLUNIT ADDRESS 
* 

* IBM 7171 
RCHANNEL ADDRESS 



SYSTEM 2 WITH 32 ASCII DEVICES 
(c40,32) ,DEVTYPE=3278,MODEL=2 

SYSTEM 1 CONTROL UNIT 
=c00,CUTYPE=3274,FEATURE=32-DEVICE 
=c20,CUTYPE=3274,FEATURE=32-DEVICE 

SYSTEM 2 CONTROL UNIT 
=c40,CUTYPE=3274,FEATURE=32-DEVICE 

SYSTEM 1 AND 2 CHANNEL 
=c , CHTYPE=BLKMPXR 



Figure 2-4. VM/SP System Generation Information 

where 'c' defines the channel address on the IBM 7171 host channel. For a 
detailed description of setting up channel addresses and Unit Control Word 
(UCW) definitions, refer to the IBM 71 71 ASCII Device Attachment Control Unit 
Description and Planning Guide . 
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2.7.2 Preparing the MVS System 



An example of the device entries for one IBM 7171 attached to a host channel is 
shown in Figure 2-5. 



* IBM 7171 SYSTEM WITH 32 ASCII DEVICES 
* 

IODEVICE ADDRESS=(cA0,4) ,UNIT=3278,MODEL=2 , 

FEATURE= ( AUDALRM , SELPEN , DOCHAR , EBKY 3277) 
IODEVICE ADDRESS=(cA4,2) ,UNIT=3286 ,M0DEL=2 
IODEVICE ADDRESS=(cA6,26) ,UNIT=3278 ,MODEL=2 , 

FEATURE= ( AUDALRM , S ELPEN , DOCHAR , EBKY 3 2 7 7 ) 



Figure 2-5. MVS System Generation Information 

where V is a block multiplexer channel and the devices are thirty 3278 model 2 
terminals with AUDALRM, SELPEN, DOCHAR, and EBKY3277 features, and 
two 3286 model 2 printers. 

Note: Preparing the MVS system also involves setting up a host disconnect 
method. Refer to section "Setting Host Disconnect Methods" on page 4-65 for 
details. 



2.8 System Start-up and Operation 



Complete the installation procedures in the publication IBM 71 71 ASCII Device 
Attachment Control Unit Description and Planning Guide to establish connection 
between the ASCII terminals and the IBM 7171. 



2.8.1 Operating IBM 7171 Terminals 



1. Insure that the terminal is ready. (Set up a valid baud rate, the correct number 
of stop bits, the correct parity, etc.) 

2. Activate the IBM 7171 power ON switch and wait about 10 seconds for the 
Diagnostics to complete. The Ready indicator light should come on. 

3 . Set the IBM 7 1 7 1 ON LINE/OFF LINE mode switch to ON LINE. 

4. Activate the power ON switch at the connected ASCII terminal. 

5. Since autobaud is the default on port definitions as delivered, the host oper- 
ating system logon display will not appear on the screen of the ASCII terminal 
when it is turned on. (However, if the default was changed to a fixed baud 
rate (autobaud off) and if the ASCII terminal type was predefined, the host 
logo would appear immediately.) 
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6. Press the key on the terminal (usually the RETURN key) that generates the 
carriage return (CR) character 7 . 

7. The following message will be displayed: 

ENTER TERMINAL TYPE: 

8. Enter the terminal type, for example, IBM3 101. If an invalid terminal type is 
entered, and the Terminal Definition Tables delivered with the IBM 7171 are 
being used, the following display of valid terminal types will appear: 

VALID TYPES ARE: 

IBM31018 IBM316X 

TVI912 TVI920 TVI950 TVI950R 

ADM3 1 ADM3A 

VT100 

DM1520 DM1521 DM3045 

TYPETERM 

ROLM3270 

ENTER TERMINAL TYPE: 

9. After entering the correct terminal type, press ENTER. 

10. The connected terminal should display the "logo" of the host operating system. 

11. Logon to the host in the normal way. 

Note: If a valid terminal type is entered other than the type of terminal at 
which the message appears, the terminal may become inoperable. To correct 
this situation, execute the procedure described in "Terminal Type Specification 
Errors" on page 8-4. 

12. If the host logon screen still does not appear, try hitting the CLEAR key. If the 
logon does not appear, the host system operator probably has not enabled the 
terminal line. Ask him to do this at the host system operator console. 



For the IBM 3101 press the key with an arrow that points down and to the left. For 
the IBM PC running the IBM 3101 Emulation Program, press the key with an arrow 
pointing to the left. In general, the key, or key sequence must be pressed that gener- 
ates the ASCII "CR" (X ' 0D ' ) code character. 

For an IBM PC running the IBM 3101 Emulation Program, IBM3101 must be used as 
the terminal type. 
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Chapter 3. Using ASCII Terminals on the IBM 7171 



This chapter is for ASCII terminal users. It explains how the IBM 7171 emulates 
3270 terminal functions for ASCII display terminals. It assumes that the user is 
familiar with the functions of a 3270 terminal. If this is not the case, the full com- 
plement of IBM 3270 Information Display System products is identified in the 
introductory publication An Introduction to the IBM 32 70 Information Display 
System, GA27-2739. For more detailed 3270 information refer to the IBM 3270 
Information Display System Data Stream Programmer's Reference, GA23-0059. 



3.1 IBM 3270 Emulated and Extended Functions 



The IBM 7171 not only emulates a 3270 terminal for its attached ASCII terminals, 
in some cases it extends these functions to make interactive text and program 
editing more effective. 



3.1.1 3270 Alternate Screen Size Support 



3270 Alternate Screen Size Support has been added. The IBM 7171 now requires 
screen size information for both the logical screen sizes (the 3278 model sup- 
ported) and the physical screen sizes (the sizes the ASCII terminal is capable of 
supporting). If the terminal physical size is too small to view the entire logical 
3270 size, there are two new input sequences defined to "Page Up" and "Page 
Down." Thus, an ASCII display that only supports a 24x80 screen can be defined 
to support a 3278 Model Group 4 (which has a 43x80 screen) and it can view the 
entire 43x80 logical screen by scrolling the 24x80 physical screen. The 3278 
Model Group 5 can also be supported by an ASCII device, as long as that device is 
capable of displaying 132 columns of output, such as the DEC VT100. In the case 
of the VT100, which can display a 24x132 screen, the Page Up and Page Down 
functions can be used to display the missing lines that a 27x132 3278 Model 5 
would display. 



3.1.2 Different Character Representation 



There are two important EBCDIC characters which are not defined in ASCII and 
therefore usually cannot be found on the keyboard of an ASCII terminal: 

- the "cent" symbol (<:) and 

- the "not" symbol (-.) 

Since these symbols can be important in certain programming languages and 
editors, the IBM 7171 represents them with two less important ASCII characters: 
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- the "backslash" (\) is used for the "cent" (<:) 

- the "circumflex accent" ( ) is used for the "not" (-1) 

The "backslash" (\) key and the "circumflex accent" O key on an ASCII terminal 
with the IBM 7171 are to be used in place of the "cent" (c) and the "not" 
symbol(-.). Note that the "cent" (0) and the "not" symbol(-i) appear on an 
ASCII terminal screen as "backslash" (\) and "circumflex accent" O, respec- 
tively. The hexadecimal notation of what appears as "backslash" (\) is X ' 4A ' , 
which is the EBCDIC code for the "cent" (0), and of what appears as "circumflex 
accent" f) is X • 5F • , which is the EBCDIC code for the "not" (-.). The usage of 
these characters may be changed by altering the translate tables, or by introducing 
a multiple key input sequence. See item 1 on page 4-64 for an example and 
4.5.2, "Function Name Table" on page 4-40. 

3.1.3 Type- Ahead Capability 

The 3270 hardware has a "keyboard lock" function which prevents the user from 
entering data before the application program is ready to receive it. In contrast, the 
IBM 7171 normally does not lock the keyboard of an ASCII terminal. It knows 
I when the keyboard of a real 3270 would be locked and does not process user input 

I until it receives a keyboard unlock from the host. This occurs because ASCII termi- 

| nals are connected through full-duplex asynchronous interface hardware, whereas 

3270 terminals operate in half -duplex mode. 

To indicate that the keyboard is logically locked, the cursor is moved to the lower 
I right corner of the screen. In this mode, up to 340 characters of user input are held 

I by the IBM 7171 in a "type-ahead" buffer. The characters that are typed do not 

appear on the screen because it has not yet been determined where they are to be 
placed. Since it is possible to type-ahead with any key, including, for example, 
ENTER and PFKs, it is quite possible that information is being typed which is log- 
ically associated with a screen image that the host computer has not yet written. 
When the host unlocks the keyboard, all the typed-ahead data appears on the 
screen where designated by the host. The resulting effect is identical if the user 
had simply waited for the host to unlock the keyboard and only then typed in the 
same information. 

It is often useful to type-ahead multiple ENTER and PFKs, but each such key 
when processed by the IBM 7171 logically re-locks the keyboard and requires 
another host reaction and another unlock request before the data following it is 
processed. 



3.1.4 Highlighted Fields 



Highlighted fields are supported on terminals that allow individual characters to be 
highlighted, but which have no true attribute bytes. An example is the DEC 
VT-100 terminal, which supports the ANSI X3.64 standard for Set Graphic Rendi- 
tion with parameter "1." The IBM 7171 supplied Terminal Definition Table for 
the DEC VT-100 provides this capability. 

Highlighting is also supported on terminals that accept attribute bytes which govern 
the display of characters following them up to the next attribute byte. Terminals 
which accept attribute bytes, but which revert to some default display mode at the 
end of a line are not supported. 
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3.1.5 Color Terminals 



3.1.6 Setup Functions 



Some terminals (e.g. Tele Video 950) can handle both the former ("mode") and the 
latter ("attribute") highlighting. The two methods cannot be mixed within the same 
Terminal Definition Table. 



Color terminals which operate in ANSI or similar modes can be defined to emulate 
IBM 3279 "basic color." "Basic color" mode means that four different colors are 
assigned to the unprotected unhighlighted, unprotected highlighted, protected 
unhighlighted and protected highlighted fields. Selection of colors is table-driven 
and must be coded in the Terminal Definition Table of the terminal type. A key- 
board sequence allows switching between alternate color selections, or between 
simple intensity highlighting and basic color modes. See "Alternate Display of 
Attributes" on page 3-9. In this way, colors need only be used when they are 
helpful. 



Most of the extended functions provided by the IBM 7171 can be initialized by the 
ASCII terminal user through Setup Functions. The setup function can be executed 
from the user terminal by a predefined key sequence. Refer to the Setup Functions 
table for a specific terminal type in Appendix B, "IBM 7171 Supplied Terminal 
Definition Tables" on page B-l. 

Normally, the setup functions are defined in pairs; one setup function initiates the 
function and the other resets it to the previous or default definition. The setup 
function may represent a standard 3270 function, a function defined within the 
IBM 7171, or one determined by the user. 

The function initiated by a setup function normally remains in effect until the cor- 
responding reset setup function is issued. Some setup functions are executed by 
control keys defined for this purpose. Powering off the IBM 7171 resets the setup 
functions to the default states. 

The following setup functions are available: 

Set Column Tab 

Delete Column Tab 

Set Left Margin 

Set Home Line 

Delete all Column Tabs, and reset Home Line and Left Margin 

Improved Null Processing 

3270 Null Processing 

Zones Mode on 

Zones Mode off 

Reverse Enter/Newline Keys 

Restore Enter/Newline Keys 

Reverse Column and Field Tab Keys 

Restore Column and Field Tab Keys 

Alpha in Numeric-Only Field 

3270 Numeric-only Fields 

3278 Insert Mode 

3277 Insert Mode 

APL Mode on 
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APL Mode off 

ASCII Input in APL Mode 

Alternate Display of Attributes 

Primary Display of Attributes 

Suppress Pacing 

Restore Pacing 

Keyboard initiated Line Drop 

Return to ENTER TERMINAL TYPE Message 

Alternate Keyboard Arrangement 

Primary Keyboard Arrangement 

n the following description the setup functions themselves appear in bold type, 
whereas the control keys are shown in CAPITAL letters. 



Set Column Tab 



Delete Column Tab 



Set Left Margin 



Automatic Indentation 



The setup function Set Column Tab allows a column tab stop to be set at any 
column position on the screen. This provides a typewriter-style, column-oriented 
tabs ("column tabs") function (the regular 3270 field tabs function is also pro- 
vided). Setup functions can be used to erase the single tab stop where the cursor is 
currently positioned (Delete Column Tab), or to delete all tab stops that have been 
defined previously (Delete all Column Tabs, and reset Home Line and Left Margin) 

After setting of the column tab stops, the COLUMN TAB key can be used to move 
the cursor from its current position right to the next column tab stop, and the 
COLUMN BACKTAB key can be used to move the cursor to the previous column 
tab stop. 



The setup function Delete Column Tab is used to erase the single tab stop where 
the cursor is currently positioned. 



The setup function Set Left Margin sets the left margin to the current cursor 
column position. The column need not be a column tab stop. Any later use of the 
NEWLINE key functions the same way as described under "Automatic 
Indentation." The setup function Delete All Column Tabs, and Reset Home Line and 
Left Margin resets the left margin to the leftmost position on the screen. 



This special feature, although not a setup function, is related to setting up column 
tabs and the left margin. The NEWLINE key normally moves the cursor to the 
first unprotected character on the next line. The IBM 7171 allows a generalization 
of the "newline function" in that it allows the cursor to be moved left to some 
other column in the next line on the screen. That means that the "left margin" is 
not fixed at the physical left end of the screen, but can be changed. After some 
column tab stops are defined on the screen, the INDENT and UNDENT keys are 
used. 

The INDENT key is used to move the cursor to the next tab stop to the right of its 
current position, exactly as the COLUMN TAB key does. In addition, however, 
this key will set that column to be the left margin for the newline function. If the 



3-4 IBM 7171 Reference Manual and Programming Guide 



Set Home Line 



INDENT key is pressed and there are no more column tab stops to the right of the 
current cursor location, the terminal will respond with an audible alarm ("beep"). 
Whenever the cursor is in a column to the right of the left margin and the 
NEWLINE key is pressed, the cursor will move to the left margin on the next line 
that has unprotected characters. If the next line has a protected character at the 
left margin, the cursor will move to the first unprotected character to the right of 
the newline left margin. If the cursor was already in that column, it will just move 
down one line. If, however, the cursor was positioned in any column to the left of 
the newline left margin, it will be moved to the first unprotected character of the 
next line that has unprotected characters. 

The UNDENT key is used to move the cursor and the left margin to the next 
column tab stop on the left of the current cursor position. If the UNDENT key is 
pressed and there are no more column tab stops on the left of the current cursor 
location, the cursor will be moved to the physical beginning of the current line. 



The setup function Set Home Line can be used to redefine the location of the home 
position ("home line") of the cursor. The line that the cursor is currently on 
becomes the home line. Pressing the HOME key will then move the cursor to the 
first unprotected position on that line. The setup function Delete All Column Tabs, 
and Reset Home Line and Left Margin resets this redefined home position. 



Delete All Column Tabs, and Reset Home Line and Left Margin 



Improved Null Processing 



The setup function Delete All Column Tabs, and Reset Home Line and Left Margin 

clears all column tab stops, resets the home line to the first line with unprotected 
characters, and resets the left margin to the leftmost position on the screen. 



Both the null (X ' 00 ' ) and the blank (X ' 20 ' ) character appear on the terminal 
screen as a blank space. However, a real 3270 terminal has its own way of treating 
nulls and blanks, which can lead to confusion, since the user cannot tell by looking 
at the screen which spaces are nulls and which are blanks. Improved Null Processing 
treats nulls and blanks in a consistent way, thus producing a "What you see is what 
you get" effect and relieving the user of the need to distinguish between these two 
characters. 

1. On a real 3270, when fields which have been modified by keyboard entry are 
read by the application, nulls are not transmitted to the host, even when they 
are imbedded among visible characters in the field. Thus, the host may "see" 
the field differently than the user, as in the following example where nulls 
occupy the space between "...BUF" and "A NEW...." 

Appearance on screen: GET INDCB,BUF A NEW RECORD 

Sent to host: GET INDCB,BUFA NEW RECORD 

Using the setup function Improved Null Processing, which is the default, the 
IBM 7171 translates nulls between characters into blanks when reading from 
the screen. The above input line would thus produce the result normally 
expected: 

Sent to host: GET INDCB,BUF A NEW RECORD 
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Trailing nulls on the line are still suppressed, because they are not significant, 
and removing them reduces the number of characters which the IBM 7171 
must process. 

On a real 3270, insert mode operates only in fields padded with nulls. In the 
following example, the symbol ' | ' represents the physical location of the attri- 
bute byte which ends the previous field and begins a new field (on the screen, 
the attribute byte displays as a blank). 



I The terminal shold do what you expect it to do. 
/ 



3270 Null Processing 



Zones Mode On 



In the above line, the missing "u" could only be inserted before the character 
above the slash if the characters at the end of the line were nulls. If the char- 
acters between the period ending the sentence and the physical end of field 
were all blanks, an attempt to insert on a real 3270 will produce an error condi- 
tion, which locks the keyboard and must be cleared with the RESET key. 
Since nulls appear as blanks, the user cannot tell if insertion is legal until he 
tries to insert a character. 

The IBM 7171 will allow either blanks or nulls to be pushed off the end of a 
field. 



The setup function 3270 Null Processing allows regular 3270 type null processing to 
be used. When in insert mode, imbedded nulls between characters will be com- 
pressed out before blanks or nulls are pushed off the end of the field. 



In the 3270 mode of operation, attribute bytes define tab stops ("field tabs") 
which not only delimit fields, but also delimit the scope of the INSERT and 
DELETE functions. Since column tabs provide an alternate tabbing mechanism 
without the use of attribute bytes, a similar mode of operation has been introduced 
which is called "zones mode." A "zone" is a part of a line on the screen which is 
delimited by two column tab stops. If there is no column tab stop on either the first 
or last physical position on the line, the area between the beginning of the line and 
the first column tab stop, or between the last column tab stop and the end of the 
line, also represents a zone. When the user is in "zones mode" and presses the 
INSERT key, the character to be inserted is placed at the current cursor position. 
The original character which was at the current cursor position and subsequent 
characters are "rippled" one position to the right. The "ripple" of characters for 
INSERT in zones mode will stop at any column tab stop which is preceded by three 
or more blanks (or nulls). When the user presses the DELETE key in zones mode, 
the character at the current cursor position is deleted and subsequent characters are 
"rippled" one position to the left . The "ripple" of characters for DELETE in 
zones mode will stop at any column tab stop which is preceded by two blanks (or 
nulls). 

The setup function Zones Mode On allows the user to select this mode of opera- 
tion. 
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Zones Mode Off 



The default setting Zones Mode Off causes the zones mode operation, previously 
selected by the setup function Zones Mode On, to be terminated. The standard 
3270 field tab oriented mode of operation is re-invoked. 



Reverse ENTER/NEWLINE Keys 



The setup function Reverse ENTER/NEWLINE Keys allows the user to reverse 
(exchange) the ENTER and NEWLINE keys. The ENTER and NEWLINE keys 
for the supported terminal types are defined in Appendix B, "IBM 7171 Supplied 
Terminal Definition Tables." In Appendix B refer to the table "Control and Cursor 
Movement Keys" for the specific terminal type. To reverse these keys, type in the 
key sequence as shown in the table "Setup Functions" in Appendix B for the spe- 
cific terminal type. 



Restore ENTER/NEWLINE Keys 



The setup function Restore ENTER/NEWLINE Keys enables the user to restore 
the previous setting of the ENTER and NEWLINE keys before the setup function 
"Reverse ENTER/NEWLINE Keys" was issued. 



Reverse Column and Field Tab Keys 



The setup function Reverse Column and Field Tab Keys allows the user to reverse 
(exchange) the COLUMN TAB with the FIELD TAB key, and the COLUMN 
BACKTAB with the FIELD BACKTAB key. 



Restore Column and Field Tab Keys 



The setup function Restore Column and Field Tab Keys is used to restore the pre- 
vious setting of the COLUMN TAB, FIELD TAB, COLUMN BACKTAB and 
FIELD BACKTAB keys before the setup function Reverse Column and Field Tab 
Keys was issued. 



Alphanumeric in Numeric-Only Field 



3270 Numeric-only Fields 



3278 Insert Mode 



The setup function Alphanumeric in Numeric-Only Field allows the entry of any 
character (including non-numeric characters) into numeric fields. 



The setup function 3270 Numeric-only Fields is used to restore the original 
numeric-only restriction to numeric fields. 



The setup function 3278 Insert Mode provides the 3278 approach of terminating 
insert mode when an attention-generating key ("ENTER," "PF" or "PA") is 
pressed. 
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3277 Insert Mode 



The setup function 3277 Insert Mode provides the 3277 approach of terminating 
insert mode, where only the insert toggle key (In Appendix B see "Toggle Insert 
Mode" in the table "Control and Cursor Movement Keys" for the specific terminal 
type) ends insert mode. 



APL Character Set - General Information 



APL Mode On 



APL Mode Off 



When using APL, the special APL character set must be displayed on the screen. 
Some terminals can display both the normal (ASCII) character set and the APL 
character set at the same time. Some terminals can only display one set at a time. 
The IBM 7171 will allow the use of either kind of terminal. When an APL char- 
acter is sent to a terminal which is not in APL display mode, or an ASCII character 
is sent to a terminal which is currently only able to display APL, the character is 
displayed as a special invalid token character (normally a blot or a colon). 

The keys on the keyboard of an APL terminal usually include both sets of charac- 
ters. The keys always send the same code to the computer whether the terminal is 
in APL mode or not. If the terminal is able to display both APL and non-APL 
characters at the same time, some keys are needed which mean "now treat every- 
thing typed as APL characters" and "now treat everything as normal (lowercase) 
letters and symbols." With such a facility, it is possible to edit lowercase characters 
into APL variables or to edit APL examples into a SCRIPT data set. 

Certain APL characters are compounds that are formed by overtyping one APL 
symbol with another. The terminal support must be able to form such compound 
characters from the keyboard and to display them on the screen. Composite char- 
acters are formed by overstriking. The rule is: if two simple (non-composite) char- 
acters are overstruck, and if both together form a valid composite, then the 
composite is formed and displayed on the screen. If the two characters do not form 
a valid composite, or if the screen position already has a composite character, then 
the keyboard input replaces the previous character. 

Much of the APL processing is automatic. However, there are three special setup 
functions which are defined to enter and exit APL mode: 



The setup function APL Mode On turns APL on and treats all subsequent input 
from the terminal as APL characters. If the terminal is only able to display one 
kind of character set at a time, receipt of this signal will also cause the screen to be 
rewritten with lowercase interpreted as uppercase and non-APL symbols changed 
to the APL illegal character token. When both character sets can be displayed at 
the same time, the screen is not automatically refreshed by this key. 



The setup function APL Mode Off turns APL mode off and treats all subsequent 
input from the terminal as normal ASCII characters. If the terminal is only able to 
display one character set at a time, activating this function causes the screen to be 
redisplayed in upper case and with APL special characters converted to the normal 
ASCII illegal character token. 
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ASCII Input in APL Mode 



The setup function ASCII Input in APL Mode can be used when the terminal is in 
APL mode. It leaves the display in APL mode but treats subsequent input from the 
keyboard as ASCII. It is used to enter lowercase letters into APL variables or when 
editing mixtures of APL and text. This key is normally available only on terminals 
which can display both APL and ASCII at the same time. It differs from APL 
MODE Off in that the APL characters on the screen continue to be displayed cor- 
rectly (if APL MODE Off is selected and APL characters are moved by the host or 
by insert mode or DEL, then they are converted to the illegal token). The key- 
board can be shifted back to APL by typing in the key sequence for the setup func- 
tion APL Mode On again. 



Alternate Display of Attributes 



The setup function Alternate Display of Attributes selects an alternate display mode, 
if one is defined. There are two setup functions which select primary or alternate 
display of attributes. On terminals with highlighting or color, there can be two 
alternate methods of displaying highlighted/normal and protected/unprotected 
fields. 



Primary Display of Attributes 



) Suppress Pacing 



Restore Pacing 



The setup function Primary Display of Attributes restores the primary mode of 
display, which is the default. 



The setup function Suppress Pacing controls whether pacing of characters is 
defined for the terminal being used. If the appropriate key sequence for Suppress 
Pacing is typed in, the local reset and control functions "Pacing Start" and "Pacing 
Stop" (normally XON/XOFF) will be disabled and the defined pacing characters 
will be treated as normal control characters. 



The setup function Restore Pacing allows the pacing characters to be used to 
control output from the IBM 7171; e.g., the local reset and control functions 
"Pacing Start" and "Pacing Stop" will be enabled again. See section 3.1.7, "Local 
Reset and Control Facilities." 



Keyboard Initiated Line Drop 



The setup function Keyboard Initiated Line Drop performs a keyboard initiated dis- 
connect. The IBM 7171 transmits a disconnect string to reset the terminal to an 
appropriate state and if appropriate, then drops the phone line. 
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Return to 'ENTER TERMINAL TYPE:' Message 



The setup function Return to ENTER TERMINAL TYPE Message returns the ter- 
minal to the "ENTER TERMINAL TYPE:" prompt to allow selection of an alter- 
nate table for this terminal. The communications link is not dropped. If a host 
session is in progress it is disconnected. 



Alternate Keyboard Arrangement 



The setup function Alternate Keyboard Arrangement logically rearranges the key- 
board to match the Dvorak keyboard arrangement. The Dvorak keyboard arrange- 
ment is a keyboard layout designed to optimize letter placement so that faster 
typing is possible. Figure 3-1 gives an example of this arrangement for the IBM 
3101. The default keyboard setting is restored by the setup function "Primary 
Keyboard Arrangement." 



lower: 1234567890-= 

/ i .pyfgcri[£ 
aoeuidhtns ' 
; q j kxbmwvz 



upper: ° ! a#$ JS-iS* ( )_+ 
?<>PYFGCRL] I 
AOEUIDHTNS" 
: QJKXBMWVZ 



Figure 3-1. Example of Dvorak Keyboard Arrangement for IBM 3101 



Primary Keyboard Arrangement 



The setup function Primary Keyboard Arrangement restores the use of the normal 
QWERTY keyboard arrangement. 



3.1.7 Local Reset and Control Facilities 



In the IBM 7171 there are six Local Reset and Control Functions, which are 
requests that are routed directly to the IBM 7171. They are not passed to the host 
but provide control over the transmission and clearing of data to and from the ter- 
minal. The functions are: 

• MASTER RESET clears all pending character or transmission error indicators, 
purges all typed ahead characters, re-transmits the terminal initialization 
sequence, rewrites the screen image from the screen image buffer and exits 
from insert mode. This function solves most user problems and is a convenient 
"panic button." 

• CHARACTER ERROR RESET clears the error condition detected indicator 
after a parity, framing, break interrupt, or overrun error from the terminal and 
makes further terminal input possible. 

• KEYBOARD UNLOCK clears the logical keyboard lock and allows further 
input to be processed. If input has been typed ahead, it will be processed 
immediately. Otherwise, input will be received from the terminal. This is 
similar to RESET on a real IBM 3278. 
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TYPE- AHEAD PURGE flushes the contents of the type-ahead buffer. This 
gives the user the ability to correct errors which have been typed in but not yet 
processed, and it is recommended if the user changes his mind or needs to 
perform some other function immediately. 

PACING START is normally XON. When this character is received and pacing 
is enabled (the setup function Restore Pacing is in effect), transmission to the 
terminal will be resumed. If transmission is not currently halted by PACING 
STOP, but pacing is enabled, the audible alarm ("beep") is sent to the terminal 
and this character is ignored. Pacing may be disabled by the setup function 
Suppress Pacing (see "Suppress Pacing") and reenabled again by the setup 
function Restore Pacing. 

PACING STOP is normally XOFF. When this character is received, and if 
pacing is enabled (the setup function Restore Pacing is in effect), transmission 
to the terminal will stop until the PACING START character (see above) is 
received. If transmission is already halted and pacing is enabled, this character 
is ignored. Pacing may be disabled by the setup function Suppress Pacing (see 
"Suppress Pacing") and reenabled again by the setup function Restore Pacing. 



3.2 Error Situations 



The following gives a description of some more important error situations which a 
user may encounter when operating an ASCII terminal. 



3.2.1 Errors on Communication Lines 



Errors can occur in data transmitted between the ASCII terminal and the IBM 
7171. When the connection is made using normal phone lines, the error can be 
caused by background noise produced by the telephone equipment. For locally 
connected terminals such errors are less common, but may still be caused by elec- 
trical interference. 

When a transmission error is detected on input data (bad parity, framing error, or 
overrun) the terminal is marked in an input error state. Every subsequent character 
received is ignored and a BEL character is echoed back to the terminal causing an 
audible alarm ("beep") to inform the user of the error state. The terminal user 
must explicitly acknowledge the error by entering the Character Error Reset func- 
tion (see 3.1.7, "Local Reset and Control Facilities" on page 3-10). After 
receiving the key sequence for this function, the IBM 7171 clears the error indi- 
cation for the terminal and normal input can continue. 

The BREAK key on the keyboard transmits a sequence which the IBM 7171 will 
regard as a character transmission error. Therefore, if a terminal user accidentally 
hits the BREAK key, he must correct the error by typing in the key sequence of the 
Character Error Reset function. Should connection with the terminal be lost due to 
modem or phone line errors, the line will be disabled and reenabled to permit the 
user to dial back in and logon. 
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3.2.2 Trying to Change Protected Data 



There are certain parts of the screen into which the user cannot type data. For 
example, in a full-screen editor there are usually sections in the top line of the 
screen which contain status information which cannot be modified. There are also 
field separators called "attribute bytes" that separate the various fields of each 
screen line, and the user cannot modify or delete these field separator locations. 
Finally, when the terminal is in insert mode, and the cursor is positioned in a field 
which is full (the last character in the field is neither 'null' nor 'blank'), then no 
additional characters can be added to the field. 

In all three cases, the IBM 7171 responds to an illegal attempt to change protected 
data, or to add to a full field, with an audible alarm ("beep") and by leaving the 
screen unchanged. 

Once the problem is corrected by moving the cursor out of the protected field, the 
IBM 7171 will continue normal operation. It is not necessary to explicitly press a 
"reset" key in any of these circumstances as would be required on a "real" 3270. 
Note, however, that the IBM 3101 Model 2x terminals will generate their own 
Lock/Reset condition when one of the block-mode-only keys is pressed. 



3.2.3 Pressing the Wrong Key 



If any control request is entered out of context, the request will be ignored and the 
ASCII terminal will respond with an audible alarm ("beep"). For example, a Char- 
acter Error Reset function issued when there is no error situation present, or a 
Keyboard Unlock function issued when the keyboard is already unlocked will gen- 
erate a "beep." Similarly, any attempt to use an undefined CTRL key (ALT key on 
the IBM 3101), ESC or PFK sequence will also generate a "beep." 

Once the problem is corrected by pressing the correct key, the IBM 7171 will con- 
tinue normal operation. It is not necessary to explicitly press a "reset" key as 
would be true on a "real" 3270. Note, however, that the IBM 3101 Model 2x ter- 
minals will generate their own Lock/Reset condition when one of the block-mode- 
only keys is pressed. 



3.2.4 Errors on Output Data Stream 



Errors may also be introduced into the output data stream transmitted from the 
host to the ASCII terminal. These errors appear as "garbage" characters some- 
where on the screen. When the user suspects that the contents of the screen is in 
error, he can request that the screen image be retransmitted. The "Redisplay" 
control function (see "Control and Cursor Movement Keys" for the specific ter- 
minal) is used to request such retransmission. Note, however, that this function 
will not take effect until the keyboard is unlocked. 
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3.2.5 Full Type-Ahead Buff er 



Within the IBM 7171 each ASCII terminal has a 340 character buffer for 
typeahead. When this buffer is filled and additional characters are typed, then the 
IBM 7171 has no place to store them and responds with an audible alarm 
("beep"). Since some data has been lost there is no automatic way to continue 
normal processing. The user could simply wait for the entire contents of the 
typeahead buffer to be processed. When the cursor moves out of the lower right 
corner, then the buffer is empty and the user can see which characters were 
received and which were lost. Then the Character Error Reset function (see 
3.1.7, "Local Reset and Control Facilities" on page 3-10) will reset the error state 
and the user can enter additional data. 



3.2.6 Manually Unlocking the Keyboard 



3.2.7 Master Reset 



There are times when the keyboard is logically locked, but the terminal user wants 
to manually unlock it. This is the case, for example, when he wants to interrupt an 
executing program with a program attention. On a 3270 this function is performed 
by the RESET key. For an ASCII terminal on the IBM 7171, there exists a Key- 
board Unlock function, which can be found under "Local Reset and Control Func- 
tions" in this chapter. If there are any characters in the type-ahead buffer when 
the Keyboard Unlock function is entered, they will immediately be processed and 
may appear on the screen in the current cursor position. Should an attention gener- 
ating key (ENTER or a PFK) be present in the type-ahead buffer it will cause the 
keyboard to lock again. For example, if while the keyboard is locked the user has 
typed 

abc<ENTER>def 

and now a Keyboard Unlock function is typed, the letters "abc" will appear on the 
screen and an ENTER notification will be sent to the host. The keyboard is log- 
ically locked by this ENTER and the "def" will remain in the type-ahead buffer. A 
second Keyboard Unlock function can be entered to unlock the keyboard again. 



For simplicity reasons, a Master Reset function has been defined, which combines 
all the possible reset services in a single function. When issued, it purges the type- 
ahead buffer, clears error indicators, ends insert mode and rewrites the screen. The 
Master Reset function is much easier to remember than the group of other reset 
functions which it can replace. When a Master Reset is done, any problem in the 
terminal communications should have been cleared up. If subsequent data con- 
tinues to generate an audible alarm ("beep"), the cursor is probably in a protected 
field (refer to 3.2.2, "Trying to Change Protected Data" on page 3-12). See 
"Local Reset and Control Functions" for the specific terminal in 
Appendix B, "IBM 7171 Supplied Terminal Definition Tables" for the key 
sequence to be issued to generate a Master Reset. 
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3.2.8 Other Errors 



For more information describing IBM 7171 error conditions refer to 
Chapter 5, "IBM 7171 I/O Interface to Terminals" for terminal errors, 
Chapter 6, "IBM 7171 I/O Interface to the Host System" for channel errors and 
Chapter 8, "Problem Determination" for general system errors. 



3.3 Functions of Specific ASCII Terminals 



Appendix B, "IBM 7171 Supplied Terminal Definition Tables" shows how ASCII 
code character sequences are related to the IBM 7171 and host processor func- 
tions. Most of this information is given in tables, which contain the key sequences 
for the following ASCII display terminals: 



IBM 3101 (Model 1 and 2 in character mode) 

IBM Personal Computer running in 3101 Emulation Mode 

Tele Video TVI 912, 920, 950 

Lear Siegler ADM 3 A, 31 

Digital Equipment VT 100 

Datamedia DM 1520, 1521, 3045 

IBM 3161, IBM 3163 

ROLM Cypress, Cedar, and Juniper. 



In addition, there are tables which describe basic functions of a typical ASCII type- 
writer terminal without specifying any brand or model. See section 
B.17, "TYPETERM Typewriter Terminal" on page B-65 for more information. 
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Chapter 4. Customizing IBM 7171 Tables 



4.1 Brief Overview 



In order for the IBM 7171 to communicate with attached ASCII devices, the char- 
acteristics of each individual device and of each communication line must be speci- 
fied. If the device type is not currently supported or the user wishes to change the 
communication line characteristics, the information must be supplied by the user. 

Within the IBM 7171, terminal information is organized into two main functional 
areas. These are: 

1 . Terminal Definition Tables 

2. Ports Configuration Data 



4.1.1 Terminal Definition Table 



A Terminal Definition Table (TDT) is a list of control character sequences that 
determine how ASCII terminals are to function. Each functionally different type of 
terminal must have its own TDT. 

The IBM 7171 contains resident TDTs for 16 different terminal types. These are: 

IBM3101 For the IBM 3101 terminal (Also used by the IBM PC in 3101 

emulation mode) 

TVI91 2 For the Televideo 9 1 2 

TVI920 For the Televideo 920 

TVI950 For the Televideo 950 

TVI950R For the Televideo 950 in modified display mode 

ADM3 1 For the Lear Siegler ADM 3 1 

ADM3A For the Lear Siegler ADM 3 A 

VT1 00 For the Digital Equipment Corporation VT 1 00 family 
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DM1 520 For the Datamedia 1 5 20 

DM1521 For the Datamedia 1521 

DM3045 For the Datamedia 3000 family 

TYPETERM For generic typewriter terminals 

HARDCOPY For 3286 printer emulation 

PLOTTER For output type devices in Transparent mode 

IBM316X For the IBM 3161 and IBM 3163 

ROLM3270 For the ROLM Corporation Cypress, Cedar, and Juniper. 

All of the TDTs for these terminals are stored in Read Only Memory (ROM). 
Additional TDTs may be added and stored in Non- Volatile RAM (NV-RAM). 
This information will not be erased when the control unit is powered down. 

Also stored in ROM is a list of addresses to the standard strings, TDTs, and trans- 
late tables. The user is advised to use the addresses found in this list for all inter- 
action. The list is found in section 4.5.4, "ROM Pointers to Internal Information" 
on page 4-44 and in Appendix E, "ROM Data Base Organization." 
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4.2 How to Specify Terminal Information. 



There are two ways for a user to specify terminal information. They are: 

• Via an automated program 

• Via the Maintenance Facility. 

Automated Program 

An interface exists for a user created program to automatically access and store 
data into memory. For details, refer to Appendix D, "Interface for User Sup- 
plied Table Modification Program." 

An implementation of this interface is supplied with the IBM 7171 and is 
described in Appendix C, "IBM 7171 Support Utility for Modifying Terminal 
Tables." 

Manual Table Entry 

The second way to enter terminal information is by using the Maintenance 
Facility. The Maintenance Facility allows the user to directly modify RAM and 
NV-RAM. For instructions on use of the Maintenance Facility, refer to 
Chapter 9, "Special Maintenance Facility and System Messages." The user 
should read and understand this chapter fully before entering the terminal 
information. 

Note: Anyone choosing to create a table generating program, or planning to man- 
ually create or modify any existing terminal table MUST have working knowledge 
of the following concepts which apply to IBM 7171 memory: 

1. Memory addresses are given as a SEGMENT and an OFFSET. For the 
NV-RAM, the segment will always be X ' DCOO ' . When an offset is given by 
itself, a segment value of X ' DCOO * can be assumed. 

2. Addresses and word values are stored byte reversed in memory. If an address 
or word X ' 1234 ' is known to exist at memory location X ' 5678 ' , the two 
bytes will be reversed. That is, the byte at address X ' 5678 ' will be X ' 34 ' 
and the byte at X ' 5679 • will be X ' 12 ' . 

3. Table addressing in the 7171 frequently uses pointers. For a definition of the 
implementation of these pointers, refer to 4.4.2, "Ports Area Layout" on 
page 4-21. 
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4.3 Terminal Definition Table Information 



4.3.1 Terminal Name 



The following information is necessary for describing a terminal type: 

• Terminal Name 

• Terminal Header Information 

• Keyboard Input Sequences 

— Non-immediate (Input Parse Table) 

— Immediate (Reset Character String) 

• Terminal Output 

— Control Sequence Strings 

— Graphic Rendition Strings 

• Translate Tables 

This section describes the terminal data required. Section 4.4, "Organization of 
Non- Volatile RAM" on page 4-19 describes the detailed layout of this data in 
7171 storage. 



Each terminal must be given a name which consists of up to eight characters. The 
name is associated with a pointer to a terminal header. 



4.3.2 Terminal Header Information 



The terminal header consists of terminal specific information and pointers to tables 
which contain terminal specific information. The terminal specific information 
defines the cursor base, APL support, highlighting capabilities, transmission delays 
and the pointers associating the terminal with the following: 

Input Parse Table 

Reset Characters 

Output Strings 

Graphic Rendition Strings 

Translate Tables 

Terminal And 3270 Screen Size Definitions 



4.3.3 Keyboard Input Sequences 



The IBM 7171 performs various functions or commands in response to keyboard 
entries. These keyboard entries can be categorized as immediate or non- 
immediate. Immediate keyboard entries (functions) are always processed as they 
occur. These are called Reset Character Keyboard Sequences and are described in 
section "Reset Character Keyboard Sequences" on page 4-9. 

Non-immediate keyboard entries are normally processed as they occur. However, 
some of these functions cause the host to inhibit input from the keyboard (i.e. key- 
board is locked) until command processing has been completed. If the keyboard is 
locked, non-immediate commands are inserted into a typeahead buffer. The com- 
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mands are executed from the typeahead buffer in sequential order. 
"Non-Immediate Keyboard Functions" on page 4-5 describes these functions. 



Non-Immediate Keyboard Functions 



Non-immediate keyboard entries are either graphic display characters or ASCII 
control sequences which perform terminal commands. Normal graphic characters 
have ASCII codes that he between X ' 20 ' and X * 7E ' inclusive. When these char- 
acters are sent from a terminal, the character is placed into the screen buffer at the 
current cursor position and is also echoed back to the terminal. Host interaction is 
not involved. Figure 4-1 lists the terminal commands supported. Details of each 
command are described in the following sections. 





FUNCTIONS SUPPORTED by the IBM 7171 




NON-IMMEDIATE FUNCTIONS 






CURSOR 


FULL SCREEN 


HOST 


OTHER 


MOVEMENT 


EDITING 


ATTENTION 


KEY 


KEYS 


COMMANDS 


KEYS 


COMMANDS 


CURSOR RIGHT 


INSERT TOGGLE 


CLEAR 


REDISPLAY 


CURSOR LEFT 


DELETE CHARACTER 


ENTER 


LOCAL PRINT 


CURSOR UP 


ERASE EOF 


TEST REQUEST 


DUP 


CURSOR DOWN 


ERASE INPUT 


CURSOR SELECT 


FM 


FIELD TAB 


RUBOUT 




(See Setup 


FIELD BACKTAB 






Functions) 


COLUMN TAB 








COLUMN BACKTAB 






PAGE UP 


NEWLINE 






PAGE DOWN 


HOME 




PA KEYS 




UNDENT 




PF KEYS 




INDENT 









Figure 4-1. Functions Supported by the IBM 7171 



Cursor Movement Keys: The cursor can be moved to other screen positions with the 
cursor movement keys (usually marked with arrows). Each depression of a cursor 
movement key moves the cursor one position in the direction indicated. Cursor 
movement wraps. If the cursor is moved off the right side of the screen, it reap- 
pears at the left side of the screen, one line down and vice- versa. If it is moved off 
the top of the screen, it reappears at the bottom and vice-versa. Each of the cursor 
movement keys is described below: 

Move Cursor Right 

The Cursor Right command indicates one depression of the cursor right key(s) 
and will cause the IBM 7171 to transmit to the terminal a cursor reposition 
command to the new cursor position with screen wrap considered. 
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Move Cursor Left 

The Cursor Left command indicates one depression of the cursor left key(s) 
and will cause the IBM 7171 to transmit to the terminal a cursor reposition 
command to the new cursor position with screen wrap considered. 

Move Cursor Up 

The Cursor Up command indicates one depression of the cursor up key(s) and 
will cause the IBM 7171 to transmit to the terminal a cursor reposition 
command to the new cursor position with screen wrap considered. 

Move Cursor Down 

The Cursor Down command indicates one depression of the cursor down 
key(s) and will cause the IBM 7171 to transmit to the terminal a cursor reposi- 
tion command to the new cursor position with screen wrap considered. 

Field Tab Key 

The Field Tab sequence causes the IBM 7171 to send to the terminal a cursor 
reposition command. The cursor is repositioned at the first character position 
of the next unprotected field on the screen. The search for a field begins at the 
current cursor position, scans left to right on a line, then wraps to the beginning 
of the next line and continues. If there is not a new field before the end of the 
screen, the search wraps to the top of the screen and continues. If there are no 
unprotected fields on the screen, the cursor is not repositioned. 

Field Backtab Key 

The Field Backtab Key causes the IBM 7171 to reposition the cursor at the 
beginning of the current unprotected field on the screen unless the cursor is 
already there. If the cursor is at the beginning of an unprotected field, then the 
cursor is repositioned to the beginning of the previous unprotected field. The 
method of scanning the screen is opposite that of the field tab. 

Home Key 

The Home sequence moves the cursor to the first unprotected character posi- 
tion on the display screen. 

Newline Key 

The Newline sequence moves the cursor to the first unprotected position of the 
next line with unprotected data. 

Indent Key 

The Indent sequence repositions the cursor one tab stop to the right of its 
current position and sets the Newline left margin to the new cursor position. If 
you press the Indent key and there are no more column tab stops to the right of 
the current cursor position, the terminal will respond with an audible alarm 
("beep"). 

Operation of the Newline key is now dependent on the position of the cursor 
and whether there are protected or unprotected characters on the lines below 
the cursor. If the cursor is to the left of the newline left margin, pressing the 
Newline key will move the cursor to the first unprotected character of the next 
line that has unprotected characters. If the cursor is to the right of the newline 
left margin, pressing the Newline key will move the cursor to the newline left 
margin on the next line which has unprotected characters or if there are pro- 
tected characters on the next line (occupying the newline left margin) the 
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cursor will be moved to the first unprotected character to the right of the 
newline left margin. 

Undent Key 

The Undent sequence repositions the cursor one tab stop to the left of its 
current position and sets the Newline left margin to the new cursor position. If 
the Undent key is pressed and there is no column tab stop to the left of the 
current location, the cursor will be moved to the physical beginning of the 
current line. 

Column Tab key 

The Column Tab sequence repositions the cursor at the next tab stop to the 
right, without regard for protected fields. The tab stops may be set by the 
application program or by the terminal user. 

Column Backtab key 

The Column Backtab sequence repositions the cursor at the next tab stop to the 
left, without regard for protected fields. The tab stops may be set by the appli- 
cation program or by the terminal user. 

Editing Keys 

Enter/Exit Insert Mode Toggle 

The Insert Mode sequence puts the terminal into insert mode. Repeating the 
Insert Mode sequence releases the terminal from insert mode. All characters 
entered into unprotected fields overtype data already in those particular screen 
buffer positions. 

Delete Character 

The Delete sequence indicates that the character in the current cursor position 
is to be deleted and everything else in that field moves one character to the left. 
If the field wraps from the end of the current line to the beginning of the next, 
the leftward movement of characters also wraps. 

Erase to End of Field 

The Erase to End of Field sequence causes the erasure of all unprotected data 
at and beyond the current cursor position up until the next field attribute. 
There is no cursor repositioning as a result of this sequence. 

Erase Input 

The Erase Input sequence causes commands to be sent to the terminal which 
changes all unprotected data areas in the screen buffer to nulls and repositions 
the cursor to the first unprotected character location on the screen. 

Rubout 

The Rubout sequence functions as a destructive backspace. Only unprotected 
fields can be affected by this function. If the Rubout function is invoked and 
the cursor can move left and remain in an unprotected field, then the character 
at that position will be deleted. 

Host Attention Keys: All of the keys listed in this section signal the host CPU via an 
Attention that input has been completed and that the device requires service from 
the host. The host should respond with a Read Modified command to pick up the 
Attention Identifier (AID) byte as well as the input generated at the device. 
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Clear 

When the IBM 7171 receives the Clear sequence from a terminal, it sends the 
Clear Screen CSS to the device. The host application may redisplay the screen 
contents or may display a new screen. 

Enter 

Enter is used to signal the end of a normal request from the device. 

Test Request 

When the Test Request sequence is sent, the Read Modified that the host sends 
in response to the Attention receives the Test Request Header (SOH % / 
STX) preceding the input data. 

Cursor Select 

The Cursor Select sequence tells the IBM 7171 that the selector pen detection 
function was performed on the keyboard. A Cursor Select AID will be gener- 
ated for the next Read Modified command. 

Program Attention Keys 

When any one of the three PA key sequences is transmitted, the next Read 
Modified command from the host will receive only the AID for the PA key 
pressed. 

Program Function Keys 

When any one of the 36 PF key sequences is transmitted, the host will receive 
the proper AID for the PF key pressed in the next Read Modified command. 

Other Key Commands 

Redisplay 

Receipt of the Redisplay sequence causes the display to be cleared and the 
screen image to be redisplayed. 

Local Print 

Receipt of the Local Print sequence causes an image of the screen to be printed 
to a hardcopy device connected to the auxiliary printer port of the terminal, if 
the terminal supports such a device. 

DUPlicate 

The DUP sequence sends a command to the terminal that puts the DUP char- 
acter on the screen and repositions the cursor to the beginning of the input 
area. When this screen is eventually sent to the host application program, the 
DUP character signals the application program that a 'duplicate' operation is 
intended for the rest of the field in which it is located. 

Field Mark 

The Field Mark sequence causes a special character to be placed in the screen 
buffer. When this screen is eventually transferred to the host application 
program, the special character in the buffer indicates the location of the end of 
a field on an unformatted screen or the end of a subfield on a formatted screen. 

| Page Up - Page Down 

| These functions can be defined when the physical screen size of a terminal is 

| incapable of handling the full 3270 logical screen size. They allow the physical 

| screen to act as a moveable window on the larger logical screen. If the physical 
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screen is already at the greatest extent it can move (i.e., a page up is executed 
and the top of the logical screen is already showing), then the audible alarm 
("beep") sounds at the terminal. Also, if the 3270 cursor position is not on the 
screen being viewed, the ASCII display cursor will be placed at the upper left 
hand corner of the screen. Any graphic character typed at this point will return 
the physical screen to the portion of the logical screen containing the 3270 
cursor position. 

Reset Character Keyboard Sequences: There are 7 special keyboard functions which 
are handled immediately by the IBM 7171 as they are received. They are exempt 
from the "keyboard lock" pacing provided for other keyboard input. For a detailed 
description of these functions refer to Chapter 3, "Using ASCII Terminals on the 
IBM 7171" on page 3-1. These sequences are stored in a string which consists of 
a series of eight characters followed by a terminating X ' FF * The data is posi- 
tional, and the IBM 7171 expects each one to be identified. The order of the bytes 
is as follows: 

1 . Reset Introducer (X ' FF ' if not used) 

2. Master Reset 

3. Character Error Reset 

4. Keyboard Unlock ("3270 Reset") 

5. Typeahead Purge 

6. Pacing Start 

7. Pacing Stop 

8. Maintenance Facility Console Toggle. 

The pacing control must be provided by single control characters. On all common 
devices this function is provided by DC1 (XON) and DC3 (XOFF). The other 
functions can be invoked by either single control characters or by two character 
sequences, beginning with a common introducer key. 

This optional Reset Introducer can be coded as the first parameter in the Reset 
Character Keyboard Sequence. Suppose the user wants to assign some of the reset 
functions to keys on the terminal which generate ESC sequences. Define the first 
RCHRS character to be ESC, after which the other entries in the remainder of the 
string (except for "Pacing Start" and "Pacing Stop") define the second character of 
a two character ESC sequence. The introducer need not be exclusively used in the 
RCHR strings. When the special introducer character is detected, a flag is set. If 
the next character is found in the remainder of the RCHR string (except "Pacing 
Start/Stop"), then the special function is invoked. If the second character is not 
matched in this list, then both the introducer and the second character are placed 
into the input buffer where they will be processed at normal priority following the 
usual keyboard lock protocol. Thus having ESC X as master reset does not pre- 
clude the definition of ESC A as cursor movement. 

The character at position 8 of the RCHR string is used as the Maintenance Facility 
Console Toggle. See Chapter 9, "Special Maintenance Facility and System 
Messages" on page 9-1 for details. 

If the terminal uses the default Reset Character Keyboard Sequences, the following 
seven ASCII control characters are reserved for these special functions: 

X • 07 • Master Reset, CTRL-G 

X ' 12 ' Character Error Reset, CTRL-R 

X • 14 ' Keyboard Unlock (3270 Reset), CTRL-T 
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X' 18 ' Typeahead Purge, CTRL-X 

X ' 1 1 ' Pacing Start (XON), CTRL-Q 

X' 13 ■ Pacing Stop (XOFF), CTRL-S 

X' 17 ' Maintenance Facility Console Toggle, CTRL-W. 



Keyboard Assignment Considerations 



There are over 60 unique keyboard functions supported. Since most terminals do 
not have 60 function keys, special techniques must be used to define any additional 
keys. One approach is to use a "shift" key (one that is held down while pressing 
another key). Such a key is the CTRL key (marked ALT on the IBM 3101), which 
typically permits the generation of all 33 ASCII control characters from the key- 
board. On the IBM 3101 with the ALT key depressed and pressing graphic char- 
acter "A" produces the ASCII control character SOH. Another approach is to use 
a special "introducer" function key which sends a two character sequence. In the 
case of the IBM 3101, eight Program Function (PF) keys provide such a capability. 
Finally, some terminals have a special function shift key which embeds the char- 
acter generated by the next normal graphic key pressed in the middle of a special 
three character sequence (e.g. SOH char CR is sent). 

The first task is to segregate the useable keys. Some keys have alternate functions 
(shifted and unshifted, for example). It is important to distinguish the codes which 
can easily be generated (unshifted) from those which require two fingers. For 
example, on the IBM 3101, the best keys are Backspace, Return, and Tab (because 
they are large and are closest to the center of the keyboard). Backtab and SEND 
would be very good, but they do not transmit anything. The next best keys are the 
cursor movement keys and DEL (they are on the right side and most people are 
right-handed). Then come ERASE EOF, ERASE EOS, and ESC. Finally, we have 
the ALT key (which requires that one hand be used to hold down ALT while the 
other presses the key), HOME, CLEAR, ERASE INPUT, and the PF keys. All 
other keys on the IBM 3101 do not transmit. Some terminals have a pad of twelve 
or more keys arranged in a 3x4 layout similar to a real 3270. Often it is tempting 
to use this pad for 12 PF keys, no matter how they are named, because much of the 
IBM documentation and assignment of meaning to PF keys is based on a particular 
layout of the PF keypad. 

The next step is to evaluate the relative importance of the various functions avail- 
able in the application environment under consideration. Usually ENTER, ERASE 
EOF, NEWLINE, TAB, DELETE, INSERT, cursor movement, and the first 12 PF 
keys are most important. Sometimes CLEAR is critical (as in CMS). Often 
ERASE INPUT is a dangerous key to have. In the distributed tables there is no 
ERASE INPUT key assignment for most terminal types. Specific applications may 
have a need for CURSOR SELECT or TEST REQUEST while most systems do 
not use them. The user must balance the keys available on a specific terminal with 
the needs of the application. 

It is usually a good idea to select keyboard assignments based on the name of the 
key itself, but key location can be important. If "ERASE EOL" is written on a key 
it may be a good idea to make it emulate the ERASE EOF function because this 
simplifies the documentation problem and reduces the amount a user must 
remember. These are not the only considerations. Also to be considered are key 
size, right-handedness, the proximity of "bad" keys (like a Master Microcode Reset 
key), and typamatic behavior to consider. Typamatic is critical for cursor move- 
ment, useful for TAB, and useless for ERASE EOF. 
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Keyboard extension techniques depend on the manufacturer's assignment of 
control sequences to the supplied edit function keys. On the IBM 3101, where all 
function keys transmit sequences beginning with ESC, the ESC key itself is ambig- 
uous and should therefore be avoided as a manual sequence introducer. Therefore, 
the ERASE EOS key is recommended as the first key of two key sequences. Other 
terminals assign control characters to the edit function keys (BS for Cursor Left, 
LF for Cursor Down, etc.). On such terminals the use of ESC is recommended as a 
function introducer key. 

Once the function introducer is chosen, there are some recommended guidelines for 
selecting the second key of the two stroke sequence for keyboard extension. One 
consideration is placement on the keyboard. The top row of the keyboard is com- 
monly used, in conjunction with the function introducer, to represent the first 12 
PF keys. This was chosen because some models of real 327x terminals have PF 
keys in this location. It is also useful to assign the second twelve PF key values to 
the task of function introducer followed by the second row of the keyboard 
(QWERTYUIOP). But this is not always possible since these characters may be 
used in escape sequences generated by other keys on the terminal. For example, 
some terminals have a BACKTAB key which sends ESC-I. If ESC is the function 
introducer, the user must choose between using the BACKTAB key for its natural 
meaning and using ESC-I as PF 20. In some environments it may be possible to 
take advantage of the case (ESC-I is BACKTAB, ESC-i is PF 20), but this would 
be risky. 

When followed by a keyboard function key, the function introducer is sometimes 
used to mean "more" (DELETE means Delete Character, Function-DELETE 
means ERASE EOF), or "opposite" (Function-TAB means BACKTAB), or 
"looks like" (Function-Semicolon is Field Mark because FM prints as a semicolon 
on most 327x models). But, in the final analysis many choices are a matter of per- 
sonal preference. 



4.3.4 Terminal Output 



Control Sequence Strings and Pointers 



Each terminal must perform certain hardware functions upon receiving a character 
sequence. Normally we think these functions occur when the associated key is 
pressed on the keyboard. However, on a full duplex terminal, the function is per- 
formed only after a string has been transmitted from the keyboard to the IBM 
7171, and another string has been sent back to the terminal. 

The IBM 7171 is not required to send back the same string that the keyboard 
transmitted. For example, it is convenient to simply associate keys with the func- 
tions printed on them. Thus if there already is a key marked HOME it is natural to 
use it to emulate the 327x HOME function. In a full screen application, however, 
the 327x HOME key requests that the cursor be positioned at the first unprotected 
position on the screen. When the user presses the HOME key on an IBM 3101, a 
two character sequence "ESC H" is sent to the IBM 7171. If the 7171 simply 
echoed back these two characters, the cursor would be positioned by the IBM 3101 
at the upper left corner of the screen. Instead, a four character sequence "ESC Y 
row col," which positions the cursor at the screen address associated with the first 
logically unprotected character position, is sent. This mapping of input string to 
different output strings is performed by IBM 7171. 
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These output strings are called Control Sequence Strings (CSS). They are specific 
to each terminal and must be found in the terminal manufacturer's specification 
manual. There are 19 defined Control Sequence Strings, but CSSs 7 and 8 are not 
used. 

Following is a list of each of the CSSs and their meanings: 

1 . Reposition is required to generate the terminal specific control character 

sequence to position the cursor. When it is received by the terminal, the cursor 
is positioned according to the data sent in the string. As such some characters 
or character strings in this control string are variable and must be dynamically 
generated using the current cursor position. The dynamic generation of cursor 
position is performed by the routines shown in the following figure: 



X'FE* 


BINX 


Binary column value 


X'FC 


BINY 


Binary row value 


X'FA' 


CHARX 


Character column value 


X'F8* 


CHARY 


Character row value 


X'F6' 


USERX 


User generated column value 


X'F4' 


USERY 


User generated row value 


X'FO' 


HARDCOPY 


Hardcopy terminal positioning 



Figure 4-2. Cursor Positioning Routine Names 

a. The two routines BINX and BINY each form a one byte binary position by 
adding the cursor base value to the column or row number. This is the 
most common cursor positioning method. The following table gives the 
hex values generated by BINX and BINY for different possible cursor base 
values. 



row/column 
(decimal) 


Base = 
HEX 


X'0020' 
ANSI 


Base = 
HEX 


X'0000' 
ANSI 


Base = 
HEX 


X'0001 ' 
ANSI 



1 
2 




20 
21 
22 


2/0 
2/1 
2/2 


00 
01 
02 


0/0 
0/1 
0/2 


01 
02 
03 


0/1 
0/2 
0/3 


16 




30 


3/0 


10 


1/0 


11 


1/1 


23 




37 


3/7 


17 


*1/7 


18 


1/8 


33 




41 


4/1 


21 


2/1 


22 


2/2 


79 




6F 


6/15 


4F 


4/15 


50 


5/0 



The ANSI X3.64 standard for terminal control sequences defines instead 
the use of character text strings for numeric values. In this scheme, column 
20 would be represented in the proper control string context by the ASCII 
character string "20" (X ' 3230 * ). The two routines CHARX and 
CHARY will produce such numeric character parameters for terminals that 
conform to this convention. When this form of addressing is used, the 
cursor base should be specified as the number (not the character) zero or 
one. The following table gives the hex values generated by CHARX and 
CHARY for different possible cursor base values. 
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row/column 
(decimal) 


Base = X'OOOO' 
HEX ANSI CHAR 


Base = X'0001 ' 
HEX ANSI CH 



1 
2 




30 
31 
32 


3/0 
3/1 
3/2 



1 
2 


31 
32 
33 


3/1 
3/2 
3/3 


1 
2 
3 


16 




3136 


3/1 3/6 


16 


3137 


3/1 3/7 


17 


23 




3233 


3/2 3/3 


23 


3234 


3/2 3/4 


24 


33 




3333 


3/3 3/3 


33 


3334 


3/3 3/4 


34 


79 




3739 


3/7 3/9 


79 


3830 


3/8 3/0 


80 



USERX and USERY invoke user supplied cursor positioning routines. The 
user may add a new cursor positioning algorithm to support a non-standard 
terminal. These routines must be entered as executable INTEL 80186 
object code. A new Terminal Definition Table must be created in 
NV-RAM with a modified cursor positioning CSS string. When the cursor 
positioning control string contains X ' F6 ' , the IBM 7171 will call a user 
supplied cursor x-positioning routine located in NV-RAM. The column 
value (zero base, e.g. the first column = X ' 0000 ' ) is passed to a special 
USERX routine via the AX register. Similarly, if the control string con- 
tains X ' F4 ' , a call to a user supplied cursor y-positioning routine occurs 
and the row value (zero base, e.g. the first row = X ' 0000 ' ) is passed to a 
USERY routine via the AX register. The user routines must return the con- 
verted x or y data to be sent to the terminal in the AX and DX registers. 
On return the user must load the CX register with a count of the number 
of bytes (0 to 4) to be sent to the terminal and issue a return instruction. 
The byte contained in AL will be sent first, followed by AH, DL, and DH, 
until the count contained in CX is exhausted. For example, to position the 
cursor to the third line on a display, the IBM 7171 loads X ' 0002 ' into the 
AX register and calls the user supplied y-positioning routine. If the ter- 
minal requires a X ' 22 ' to perform this movement, the routine would 
return X ' 22 ' in AL and a byte count of X * 0001 ' in CX. In this case 
data returned in registers AH, DL, and DH are ignored. All registers are 
saved before the call to the user routine and restored after the return. 

The user may enter his routines using the "Store to CPU Board Memory" 
command of the Maintenance Facility. The interface to these customized 
cursor positioning routines is defined below. 

segment: offset contents description 

(byte reversed) 

DC00:02F6 BA71 USERX offset address 

DC00.-02F8 00DC USERX segment address 

DC00:02FA BA71 USERY offset address 

DC00:02FC 00DC USERY segment address 

The user must modify the offset addresses to point to his routines which 
must be located in an unused part of NV-RAM. The segment addresses do 
not need to be changed. The offset addresses as delivered point to a 
dummy routine in ROM at X ' DC00.7 1BA * which sets the byte count in 
register CX to zero and does a return. For example, to add a USERX 
routine at X ' DC00:400 ' and a USERY routine at X ' DC00:420 • enter 
the following Store commands using the Maintenance Facility: 

s DC00:2F6 0004 
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s DC00-2FA 2004 

s DC00:400 <object code for USERX, X ■ CB ' return> 

s DC00:420 <object code for USERY, X ' CB ' return> 

d. HARDCOPY invokes a routine which attempts to provide a useful approx- 
imation to cursor positioning on a hardcopy terminal, which is assumed to 
respond in the usual way to ASCII CR and LF. Cursor left and right are 
both used as defined in CSS 5 and 6 and any change of row causes move- 
ment down the page. 

2. Erase to End of Line is the terminal defined control sequence to generate the 
standard erase to end of line function. 

3. Local Print is sent to terminals which can print an image of the screen to a 
hardcopy device connected to an auxiliary printer port of the terminal. It will 
invoke the local print function on this type of terminal when the appropriate 
input sequence has been recognized. 

4. Tone is the control sequence string that generates an audible alarm ("beep"). 

5. Cursor Left is the control sequence string to move the cursor on the screen one 
character position to the left. 

6. Cursor Right is the control sequence string to move the cursor on the screen 
one character position to the right. 

7. ~ not used — 

8. ~ not used — 

9. Signal Insert Mode is a string which is sent to the terminal when the user has 
entered insert mode. 327x terminals have insert mode indicators. Transmitting 
the terminal defined "Signal Insert Mode" CSS to an ASCII terminal should 
generate an equivalent indication for the insert status on that terminal. Some 
terminals have one or more lights or indicators which can be turned on or off 
under program control. On other terminals, the cursor might be set to blink 
when in insert mode but not to blink normally. 

10. Signal End Insert Mode is a string which should turn off the insert mode indi- 
cator when the terminal user leaves insert mode. 

11. Disconnect is a string sent to the terminal on a host initiated or keyboard initi- 
ated line drop. 

12. Clear Screen is the control sequence that clears the display screen and selects 
the default screen size. 

13. Terminal Initialize is a string which is sent to the terminal at initial connection 
(dial up, or power on) after the terminal type has been determined, or on 
receipt of a Master Reset sequence from the terminal. For example, on a ter- 
minal conforming to ANSI X3.64 it might be appropriate to send the RIS 
(Reset to Initial State) control function to clear any inappropriate protected 
fields, partial screens, insert or other modes, and other logical states left over 
from a previous session with another computer system. 
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14. Illegal ASCII Character is a character or string which is written to the terminal 
to represent an unprintable character. The TDTs supplied with the distributed 
system use a colon (:) for this purpose. However, on certain terminals it may 
be desirable to choose a less ambiguous character. For instance, if the user has 
only Model 2x versions of the IBM 3101 terminal, a suitable alternate choice 
might be: 

ESC,E (X , 1B45') 

which writes an unusual graphic character (normally called the "SEND 
MARK") that produces a unique display. On the other hand, on the IBM 
3101 Model lx it is possible to display a square blot on the screen with the 
more complicated 

DLE,STX,DEL,DLE,ETX (X • 10027F1003 ' ) 

Although this string contains five control characters, it produces the required 
result to be the illegal character token: it displays something unusual in the 
screen position, occupies only one space on the screen, has no effect on the 
characters which follow or precede it, and when done it has advanced the 
cursor one position to the right. Screen wrap at end of line is also handled 
properly. 

15. Illegal APL Character is a special string for displaying illegal characters in APL 
mode. The normal setting for this string is: 

n,BS,z (X'6E087A') 

The lower case here is misleading. The control sequence strings are never 
translated by the APL mode setting, so lower case prints as upper case. "N" 
overstruck with "Z" produces a fairly solid blot on most APL terminals. 

16. APL ON provides a string which may exist on terminals to turn APL mode on 
to permit display of both APL and normal ASCII characters on the same 
screen image. 

17. APL OFF turns APL mode off again. 

APL ON/OFF provides two strings which may exist on terminals to turn APL 
mode on and off dynamically to permit display of both APL and normal ASCII 
characters on the same screen image. On most terminals with dynamic APL 
capability, the control character SO (Shift Out) turns APL mode on and SI 
(Shift In) turns it off. However, it is possible that some other terminals would 
use another control sequence for this purpose. 

18. Display Mode is a string that the IBM 7171 uses to support highlighting and 
basic color (see "Graphic Rendition Strings" on page 4-16 for details). 

19. Alternate Clear Screen is the control sequence that clears the display screen and 
selects the alternate screen size. 
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Graphic Rendition Strings 



SGR stands for Set Graphic Rendition and is borrowed from the ANSI X3.64 
standard document where it is the name given to the control string which performs 
the highlight/color function. For this string to be invoked, the X ' 0800 ' FLAGS 
bit must be set ON in the terminal header of the given terminal type (see "Terminal 
Header Information" on page 4-28). The SGR string in conjunction with the 
eighteenth Control Sequence String defines the display modes highlighting and/or 
basic color. 

Special routines (BINFLD and CHARFLD) are called from the eighteenth CSS. 
Each routine operates in conjunction with the SGR string for this terminal type and 
the attributes of the current field to perform the highlight/color function. 

On an IBM 3277 or 3278 the only form of alternate display available is highlighting, 
and therefore only the highlight attribute is important. On the 3279, however, 
there is a mode of operation called basic color in which four different colors are 
assigned to the unprotected unhighlighted, unprotected highlighted, protected 
unhighlighted, and protected highlighted fields. The IBM 7171 can support this 
philosophy of display, but requires more flexibility than the 3279 hardware pro- 
vides. 

For one thing, while every color CRT has 6 colors plus black and white, there are 
substantial differences between the brightness of different choices. On most 
screens, blue is too dark to be read against a black background. Red is better, but 
is still uncomfortable to read. Yellow may be difficult to distinguish from green, 
and white is difficult to distinguish from cyan. Thus, selecting a usable set of four 
distinguishable colors can result in different choices for different devices. Further- 
more, there are alternate modes of display, such as reverse video, blink, or under- 
score, which may be used even on a monochrome terminal to achieve four 
distinguishable field display modes. Finally, different applications may require dif- 
ferent choices of the four display options. 

To accommodate these requirements, each terminal type is associated with an SGR 
string which supplies a primary and an alternate graphic rendition of the four pos- 
sible combinations of protect and highlight field attributes. A fifth parameter is 
supplied for nondisplay fields. 

The field attribute of the current display field is used to index into the first 
(primary) or second (alternate) half of the SGR string to find the parameter which 
sets the terminal to the right mode. The index values are: 

Nondisplay 

1 Normal intensity unprotected 

2 High intensity unprotected 

3 Normal intensity protected 

4 High intensity protected 

The selection of the first or second half of the SGR string is made by the setup 
functions "Primary /Alternate Display of Attributes" in 3.1.6, "Setup Functions" 
on page 3-3. 

The value of the byte selected in the SGR string can be used in the eighteenth CSS 
in one of two ways. If BINFLD (X ' EE ' ) is specified in the string, the contents of 
the byte are substituted into that position in the string directly as an ASCII char- 
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acter value. If CHARFLD (X ' EC ' ) is specified, the byte selected is assumed to 
contain two four bit fields representing a packed integer which should be turned 
into its ASCII character representation and substituted into the current position. 

For example, the ADM31 family of terminals (including the TVI950) has a normal 
intensity mode which is triggered by ESC followed by left parenthesis (X ' 28 ' ) and 
a half intensity mode which is triggered by ESC followed by right parenthesis 
(X ' 29 ' ). Unfortunately, the half intensity is usually too dim to be acceptable in a 
normally lighted room. Even so, half intensity may, in some cases, serve as an 
alternative. Thus, the SGR string (5 bytes of primary followed by 5 bytes of alter- 
nate) is: 

X ■ 2828282828 • ,X ■ 2829282928 • 

and the corresponding eighteenth control sequence string is: 

ESC(BINFLD) or X • 1BEE ■ 

In primary display mode, a X ' 28 ' will always be substituted after ESC in the 
output string, and all fields will be written in normal intensity. In alternate display 
mode, a X ' 29 ' will follow escape in normal intensity fields (whether protected or 
not) and they will be displayed in half intensity. 

An increasing number of terminals conform to the new ANSI X3.64 standard, and 
many color terminals support the ISO extensions to this standard. There is a phi- 
losophy in this standard that parameters should be expressed as the ASCII char- 
acter form of numbers embedded between an introducer of ESC, LBRACK and an 
alphabetic terminator. For display attributes, the terminator is lower case m. 
Under these standards the parameter for a normal field would be zero and a high- 
lighted field would be one. Under the ISO extensions, the colors are standardized 
as two digit parameters in the range 30 to 37. 

The SGR string for such a standard terminal which has a monochrome primary 
display mode and an IBM basic color selection as the alternate display would be: 

X' 0000010001, X' 3737333631 ' 

with a corresponding eighteenth control sequence string of: 

ESC,LBRACK,(CHARFLD),LCM or X ' 1B5BEC6D ' 

The CHARFLD routine will substitute the one byte ASCII characters "0" or "1" 
in normal display, and the two byte character strings "37," "33," "36," or "31" in 
alternate mode. 



4.3.5 Translate Tables 



Different terminal types may be assigned to different host and terminal character 
translation tables. The supplied default tables are suitable for normal ASCII to 
EBCDIC and APL support. However, on devices with specialized character sets, 
or in countries with different national character assignments, the user may wish to 
construct his own specialized translate tables for specific terminals or applications. 
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The function of the host translate tables is to provide a means of changing char- 
acter sets between the EBCDIC based host and the ASCII based representation of 
the terminal screen image in the IBM 7171. The internal screen image buffer con- 
tains an extended ASCII character set. For more information refer to 
Appendix A, "ASCII and EBCDIC Data Conversion Tables." Similarly, the func- 
tion of the terminal translation tables is to provide a means of changing character 
sets between the extended ASCII code used in the representation of the terminal 
screen image and the ASCII terminal. 



4.3.6 Steps in providing User-Generated TDTs 



In order to provide new IBM 7171 terminal types, technical information must be 
obtained for the terminal type to be generated. The required technical information 
is available in the manufacturer's technical reference manual. 

The following is a suggested approach to building a Terminal Definition Table: 

1 . Define a minimal set of input sequences sufficient to logon and logoff. At 
minimum include: ENTER, PF1 ... PFn, Left, Right, Up, Down, HOME, and 
CLEAR. 

2. Define Reset Characters for pacing on and off only. 

3. Define Control Sequence Strings for Cursor Position, Erase to End of Line, 
and both Clear and Alternate Clear. Do not set the flag for highlighting. 

4. Logon and test cursor positioning and host Attention generating keys. Modify 
those sequences until screen output is correct. 

5. Add terminal initialize and highlighting output sequences. Turn on the high- 
light flag and define a Graphic Rendition string. Test and modify those 
sequences until screen output is correct. 

6. Add Insert On/Off, APL, etc. Test and modify those sequences until screen 
output is correct. 

If terminal screen output is correct, the input sequences will be technically easy to 
do. If the terminal screen output is NOT correct either the device cannot be 
defined to look like a 3270 terminal or technical assistance is required. 

Some terminal keys do not transmit, thereby producing undesired effects (e.g. 
CLEAR key clears screen and does not transmit a sequence to the 7171). Such 
keys are unusable. If Cursor keys do not transmit, an alternate sequence MUST be 
defined (Ctrl-R, L, U, and D is one solution). 

Remember that Reset Characters have priority over input sequences. Reset char- 
acter conflicts are probably the second most common problem in terminal defi- 
nitions (the most common is wrong parity/baud rate in the port definition). 

It is recommended that new terminal tables should be tested prior to putting a new 
table into operation. 
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4.4 Organization of Non- Volatile RAM 



NV-RAM is divided into 4 basic areas: 

1. Data Area 1 

2. Port Configuration Data 

3. Data Area 2 

4. Terminal Definition Table (TDT) Area. 

The organization of NV-RAM is as follows: 

DCOO: 0000 

DC00:0010 

DC00:0210 

DC00-.02A8 
DC00:02EE 
DCOO: 0300 

DCOO: 1FFD 



Data Area 1 


Ports Area 


Data Area 2 


Terminal Type Messages 


T 
E 


D 
E 
F 






Reserved 


R 
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N 


A 


A 
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Information 
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TDT's 
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N 







Figure 4-3. IBM 7171 NV-RAM layout 



IMPORTANT - All of NV-RAM is located in memory on the CPU board starting 
at segment X' DCOO'. 

Following is a brief description of the data contained in each area: 

Data area 1 

This data area contains statistical information about NV-RAM as well as 7171 
system control information. 

Port Configuration Data 

This area contains the information necessary to configure the 64 communi- 
cations ports. The values contained in each port definition are used to bind 
information about the port to any device that connects to that port. This block 
contains the following information: 

• Address used to associate a valid terminal types list. 

• Baud rate of device connected 

• Parity, number of data and stop bits for device connected 

• Address of default terminal type. 
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Data Area 2 

This data area contains error message information for the Maintenance Facility. 
Error messages are stored in NV-RAM so that they are not erased when the 
system is powered down. 

TDTArea 

This area contains the following information: 

1 . The 'ENTER TERMINAL TYPE: ' message 

2. The 'VALID TYPES ARE: ' message 

3. The complete list of terminal types (including those in ROM) 

4. All user supplied TDTs. 

4.4.1 Data Area 1 Layout 

Following is a list of the data stored in Data Area 1 of NV-RAM: 

Address Data Meaning 

0000 Length of NV-RAM. Defaulted to X • 2000 ' (8K bytes). 

0002 Address of the first unused location in NV-RAM. 

0004 Number of bytes to be allocated to the 3270 data stream buffer. 
Defaulted to X'2E80' (11.6K bytes). 

0006 Erase/Write Optimization buffer size. Zero implies no optimization. 
Defaulted to X • 0BA0 • (2976 bytes). 

Note: This is not large enough to support Erase/Write Optimization on 
a terminal emulating a 3278 Model 4 or 5. It must be increased if 
Erase/ Write Optimization is desired for these devices. The IBM 7171 
must be powered off then on for the change to take effect. 

0008 System Control Flags. Defaulted to X ' 0000 ' 

Flag 

Bit Meaning 

8000 Suppress initial Device End on line initialization. 
4000 Type of terminal emulated. 

On or 1 = 3277 Emulation 

Off or = 3278 Emulation 
2000 Ignore first host initiated line drop request after line initialization. 
1000 Disable XOFF as a termination condition for Transparent 

Write/Read. 
0800 3270 CLEAR key option. 

On or 1 = Don't change to default screen size on CLEAR 

Off or = Change to default screen size on CLEAR (normal 

3270) 
0400 Ending Status for one byte write (WCC only) in Transparent 
Mode. 

On or 1 = Send only Device End 

Off or = Send Device End, Attention 
0080 Ignore high order bit of input from terminal. 
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0020 Stick bit for output parity generation when high bit of input is 
ignored. 

On or 1 = High order bit is generated as Mark or Space parity 
Off or = High order bit is generated as Even or Odd parity 
0010 Parity bit for output parity generation when high bit of input is 
ignored. 

On or 1 = Even or Space parity 
Off or = Odd or Mark parity 

Note: The preceding three bits are intended to be used when parity 
is to be ignored on input. The port should be configured with 
eight data bits, parity disabled. 

This configuration option can be done on a per port basis, or 
at a system level. The above system level configuration 
option supersedes any port specific settings. 



000A Address of logoff message which is sent to the host when using the Send 
Predefined Message to Host Disconnect Method. See "Setting Up the 
Send Predefined Message to Host Method" on page 4-65 for an 
example. 

000C Sense information for synchronous host disconnect. 

000D Status information for synchronous host disconnect. 

000E Sense information for asynchronous method of host disconnect. 

000F Status information for asynchronous method of host disconnect. 



4.4.2 Ports Area Layout 



Each of the 64 port addresses uses eight bytes for configuration. This ports config- 
uration area starts at X ' DC00:0010 ' where the configuration for port zero is 
stored. The eight bytes are defined as follows: 

Byte # Meaning 

0-1 A terminal header pointer (valid values are identical to those for bytes 

6-7). 

The terminal names list (see "Terminal Names Information" on 
page 4-26) can consist of a number of sublists. This word is used to iden- 
tify the sublist from which the Valid Terminal Types for this port are 
found. 

If this area contains a non-zero value, then this field is used to match with 
a terminal name, and the sublist that contains this terminal name is used. 

If this area is zero, or contains a value that cannot be matched to a name, 
then the sublist beginning at DC00:300 is used. 
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2-3 Baud Rate. If the baud rate is left null (the default setting) or is invalid, 
the terminal will enter autobaud detect mode. When a terminal is in 
autobaud detect mode, the terminal user must press the carriage return 
key. The IBM 7171 will then automatically determine what baud rate the 
terminal is set at. The following baud rates are autobaud detectable: 300, 
600, 1200, 1800, 2400, 3600, 4800, 9600 and 19200 baud. The fol- 
lowing baud rates are supported, but are not autobaud detectable: 50, 75, 
110, 134, 150, 2000, and 7200 baud. 

4-5 Terminal Flags. 

Byte 4 Flags 

Bits Meaning 

20 Stick bit. 

Off or = Parity bit is interpreted as Even or Odd 

On or 1 = Parity bit is interpreted as Mark or Space 
10 Parity - depends on the current setting of the Stick bit. 

Off or = Odd or Mark parity 

On or 1 = Even or Space parity 
08 Parity enable. 

Off or = Parity disabled 

On or 1 = Parity enabled 
04 Number of stop bits. 

Off or = 1 stop bit 

On or 1 = 2 stop bits 
02-01 Number of data bits. 

00 = 5 data bits 

01 = 6 data bits 

10 = 7 data bits 

11 = 8 data bits 

Byte 5 Flags 

Bits Meaning 

0080 Ignore high order bit of input from terminal. 
0020 Stick bit for output parity generation when high bit of input is 
ignored. 

On or 1 = High order bit is generated as Mark or Space 

parity 

Off or = High order bit is generated as Even or Odd 

parity 
0010 Parity bit for output parity generation when high bit of input is 
ignored. 

On or 1 = Even or Space parity 

Off or = Odd or Mark parity 

Note: The preceding three bits are intended to be used when 

parity is to be ignored on input. The port should be con- 
figured with eight data bits, parity disabled. 

This configuration option can be done on a per port 
basis, or at a system level. The above port level config- 
uration option is only effective if the system level has not 
been specified. 
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02-01 Type of connection. 

00 = Let 7171 determine type of connection 

01 = Switched Network (telephone line) 
10 = Leased Line 

11= Direct Connection 

6-7 Terminal Header Pointer. This word can have one of three values: 

. Null 

. The address of a TDT 

• A ROM index to an address list which contains the address of a TDT. 

If this word is left null, the terminal user will be prompted with the 
'ENTER TERMINAL TYPE:' message. If the value is filled in, the ter- 
minal type will be automatically selected when the terminal connects. 

Addresses are offsets relative to segment X ' DC00 ' , and are stored byte 
reversed. Addresses can point to either NV-RAM or ROM. 

Table addressing in the 7171 frequently uses pointers. In this context the 
term "pointer" has a unique definition: 

If bit 15 (the MSB) = 

THEN 

The contents of the pointer are a relative 
(to segment X'DCOO') address (maximum of 32k). 
ELSE 

The contents of the pointer are an index that 

is converted into a displacement into the 

beginning of IBM 7171 ROM (relative address X'4000 1 ). 
Bits 6-0 of byte 6 are the ROM index and allow 

addressing of the 256 entries (512 bytes). 
Thus pointer (index) X*8000' will address the 

ROM location the address of which is at X'4000'. 

See Figure 4-9 on page 4-44 for indices and corresponding 

ROM addresses. 

The location in ROM contains the relative address of 

the named table or character string. 

As an example, consider the following 8 bytes: 

F0 03 00 4B 1A 03 00 00 

This port is configured to use the Valid Types List of the TDT pointed to by 
DC00:3F0, a baud rate of 19200, even parity, parity enabled, 1 stop bit, 7 data 
bits, direct connect. Since no terminal type is assigned, the Valid Types List 
described above will be displayed if the first 'ENTER TERMINAL TYPE:' prompt 
is not satisfied. Here is another example: 

00 00 00 00 0A 00 00 80 

This port is configured to use the Valid Types List starting at X ' DC00:300 ' , 
autobaud detect, odd parity, parity enabled, 1 stop bit, 7 data bits, default con- 
nection, and will automatically connect as an IBM3 101 (X ' 8000 ' is the ROM 
index value for the IBM3 1 1 TDT) . 
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4.4.3 Data Area 2 Layout 

Following is a list of the data stored in Data Area 2 of NV-RAM: 
Address Data Meaning 

0210 Address of the first error message in the queue. 

0212 Address of the last error message in the queue. 

0214 Start of the error message area. 

Each error message consists of 10 bytes. Error messages are stored sequentially, 
starting with message 0. Following is a description of the 10 bytes: 

Byte Meaning 

Device number. 

1 Message number identifying the error that occurred. 
2-3 Date of occurrence. 

4-9 Passed parameters. 

Other words of consequence stored in this area are described below: 

Address Data Meaning 

0290 Maximum time in milliseconds Data Set Ready (DSR) can drop while the 
line is still considered to be connected. Default value is 100 milliseconds. 

0292 Maximum time in milliseconds Receive Line Signal Detect (RLSD) can 
drop while the line is still considered to be connected. Default value is 
500 milliseconds. 

0294 Erase Write Optimization Baud Rate 

Erase/ Write Optimization can be enabled as a function of the baud rate. 
This word specifies the baud rate above which no optimization will be 
performed. The default is 7200. 

0296 Keyboard Unlock Delay 

Not all IBM operating system software was designed with typeahead in 
mind. For example, in VM when an application program is invoked from 
the command line, there are a series of host write commands sent to 
update the screen before the application program gets control. These 
writes logically unlock the keyboard. If there is typeahead input when 
this occurs, that input will not be processed by the application, but by 
VM. To help minimize this effect, the IBM 7171 provides an optional 
timed delay of the keyboard unlock by a host write command. The word 
value at this location is a hex number representing the number of 32 
millisecond time intervals between the time a keyboard unlock command 
is received from the host and the time the keyboard is actually unlocked. 
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The default value is zero which means that there is no time delay. In 
most cases this will let typeahead input be processed by the program for 
which it was intended. For those cases where this is not true the system 
operator can chose a value for his installation which his users find satis- 
factory. 

4.4.4 TDT Area Layout 

The TDT area starts at address X' DC00:02A8 ' , and is divided into the following 
parts (See Figure 4-3 on page 4-19): 

Terminal Type Message Area 

This area contains the 'ENTER TERMINAL TYPE:' message, the 'VALID 
TYPES ARE:' message, and message area information. 

Reserved 

This area must remain intact to maintain the integrity of NV-RAM. 

Terminal Names Information Area 

This area contains the list of valid terminals. 

Terminal Definition Tables 

This area contains user defined TDTs. 

Terminal Type Message Area 

This area is broken up as follows: 

Address Definition of Stored Data 

02A8 The length of the 'ENTER TERMINAL TYPE:' message is stored here. 

02AA The 'ENTER TERMINAL TYPE:' message is stored here. Any message 
may be put in its place. 

02CC The length of the 'VALID TYPES ARE:' message is stored here. 

02CE The 'VALID TYPES ARE:' message is stored starting at this location. 
Any message may be put in its place. 

Extra space is left at the end of each of the messages. This is so the message can 
be changed without changing all of NV-RAM. 

Reserved Area 

Warning: Do not alter this part of NV-RAM. This area (X ' 02EE • 
through X • 02F3 ' ) is used by the IBM 7 17 1 to determine the validity 
of NV-RAM. If the data expected is not found here, NV-RAM will 
be rewritten with all default values. All user supplied information will 
be erased. 
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Address Definition of Stored Data 

02F4 The time in milliseconds to delay initialization of the terminal. Default 
value is zero. 

02F6 The address (both segment and offset) of USERX cursor positioning. 

02FA The address (both segment and offset) of USERY cursor positioning. 

02FE Reserved 



Terminal Names Information 



This is the information that appears immediately after the 'VALID TYPES ARE:' 
message. It is the list of sublists of all valid terminal names that will be recognized. 

This area provides the following information: 

• Terminal Name 

• Layout of Terminal Name message that immediately follows the *VALID 
TYPES ARE:' message 

• Pointers to the Terminal's TDT. 

The information is stored sequentially starting at address X ' DC00:0300 * in the 
following order: 

1 . Terminal Name, in upper case ASCII. The terminal name must be left justified 
and blank padded to eight characters. 

2. Pointer to the TDT. The pointer can take one of two forms: 

a. An address of a TDT. 

b. An indirect index into ROM. These are the same values as those used in 
ports configuration. For a list of these values, refer to 

Appendix E, "ROM Data Base Organization" on page E-l. 

3. An optional carriage control or list transfer word. This word can take the fol- 
lowing forms: 

• X ' FFFF ' indicates that there is to be a carriage return after this terminal 
name is printed on the screen. 

• X ' FFFE ' indicates that all terminal names following this are to be 
'hidden'; that is, they will not be printed on the screen. 

. X ' FFFD ' indicates the end of a sublist. 

Breaking the valid terminal types into sublists is optional. It is useful when 
terminals with 3270 alternate screen sizes are defined and the host system 
contains addresses allocated for alternate screen sizes. 
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Terminal Definition Tables 



As an example, suppose the host system generation defines ports 0-7 as 
3278 Model 2 terminals and ports 8-15 as 3278 Model 5 terminals. If only 
the default 7171 terminal definition tables are used, (all default tables 
support Model 2 displays) and a VT100 connects to port 8, an Operation 
Check is generated back to the host, indicating that the terminal type 
defined has too small a screen to handle the larger Model 5 buffer 
addresses. 

To prevent this, two separate terminal names sublists are set up. The 
location beginning at X ' 300 ' can contain the default definitions along 
with any other customer defined TDT's for 327x Model 2 emulation 
already defined. After these definitions and before the X ' 0000 * list ter- 
minator, place a X ' FFFD ' (sublist terminator). If a new terminal type is 
defined with Model 5 screen size parameters, it can be placed here. Thus, 
a port defined at the host as a Model 2 will only be presented with valid 
types for a Model 2, and a port defined as a Model 5 will only see those 
types valid for a Model 5. 

• If the high bit is set, and the first byte is not X ' FF ' , the remaining 15 bits 
are taken to be an address to transfer to. The next terminal name will be 
sought at the new address. 

• If the word is null (X ' 0000 ' ), then the end of the list is indicated. 

Please note that the end of list word must appear. If it does not, results are 
unpredictable. 

The information for each valid terminal follows sequentially after the previous one. 
Thus, this area contains a continuous list of terminal information. 



The user defined TDTs appear in NV-RAM following the Terminal Names Data. 
All pointers to TDTs actually point to the first byte of the Terminal Header Infor- 
mation. 

Note: Since all TDTs use many different levels of indirection, it is possible for 
several TDTs to share data. For instance, if it is desired to have all terminals use 
the same 'Reset Characters' string, there need be only one string of 'Reset 
Characters' and each TDT can point to it. In this way, it is possible to optimize the 
amount of space used. 

The TDT is broken up into the following three parts: 

• Terminal Header Information 

• Control Sequence Strings and Pointers 

• Input Parse Tables. 
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Terminal Header Information: The first part of the TDT is the Terminal Header 
Information. The Terminal Header has ten items and each item occupies two bytes 
of storage except for the Screen Size Definitions which require eight bytes. These 
twenty six bytes provide basic information about the specific terminal. 

Item Definition of Stored Data 

1 Status Flags 

2 Pointer to Initial Parse Table Entry 

3 Pointer to First CSS Pointer 

4 Cursor Base 

5 Pointer to Host Translation Table Addresses 

6 Pointer to Terminal Translate Tables 

7 Pointer to Reset Character String 

8 Delay 

9 Pointer to Set Graphic Rendition String 

10 Screen Size Definitions 

A description of each of these fields follows: 

1. Flags. 

The Flags parameter can be used to set bit flags which describe special ter- 
minal characteristics. The following flags can be specified: 

Byte Flags 

Bits Meaning 

X ' 80 ' Hardcopy terminal. 

X * 40 ' Can dynamically switch from APL to non-APL and back under 

program control (usually SI and SO characters). 
X ■ 10 • Type of APL keyboard 

On - bit paired terminal. 
Off - typewriter paired terminal. 
X ' 08 ' Highlighting can be performed. 
X ' 04 ' Highlighting is a mode of output, where characters written after an 

escape sequence are displayed highlighted, rather than an attribute 

byte, where characters in the following screen positions change 

display without themselves being rewritten. 

Byte 1 Flags 

Bits Meaning 

X * 80 ' New format terminal header containing physical and logical screen 
size information. 
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X ' 40 ' Can display character in the lower right corner without scrolling 

the screen. 
X ' 20 ' Use "real" 3270 algorithm to suppress all nulls on READ MODI- 
FIED response. If not specified embedded nulls will be returned to 
the host as blanks. 
X ' 10 ' Pacing control 

On - Default pacing to off. 
Off - Default pacing to on. 
X ' 08 ' Highlighted Blank Treatment 

Off - No difference between highlighted and unhighlighted 
blanks. 

On - Highlighted and unhighlighted blanks display differently. 
X 1 04 ' 3286 printer emulation desired (when set with Hardcopy Terminal 
bit). 

2. Pointer to Initial Parse Table Entry. 

This points to the keyboard input parse table data. The parse table parses 
input characters from the keyboard and determines what action to take. The 
Input Parse Table is discussed in "Input Parse Table" on page 4-33. 

3 . Pointer to First CSS Pointer. 

This points to a list of pointers. The list, in turn, points to the individual CSSs 
(control sequence strings) described in "Control Sequence Strings and 
Pointers" on page 4-11. 

4. Cursor Base. 

The cursor base allows a numeric or character base to be used in generating 
direct cursor addressing strings to be specified. Some terminals number the 
rows and columns starting at zero, while others start at one. For some termi- 
nals, a single ASCII character represents a row or column number based on its 
binary value in the ASCII character set. Other terminals convert the row or 
column number to a "printable" numeric character string. The cursor base is 
used in any of these cases to specify the proper value for the first row or 
column. The cursor base is added to the row or column number addressed to 
generate the proper cursor reposition sequence. 

5. Pointer to Host Translation Table Addresses. 

This is a pointer to a list of Host Translate Table addresses. The list of Host 
Translate Table addresses must be 20 bytes long, and must appear in this 
order: 

a. Host Read 3277 (ASCII to EBCDIC) 

b. Host Read 3277 Attribute and APL 

c. Host Write 3277 (EBCDIC to ASCII) 

d. Host Write 3277 Attribute and APL 

e. Host Write 3278 (EBCDIC to ASCII) 

f . Host Write 3278 Attribute 

g. Host Write 3278 APL 

h. Host Read 3278 (ASCII to EBCDIC) 
i. Host Read 3278 Attribute 
j. Host Read 3278 APL 
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The address of the standard list is found at offset X • 40E2 ' (See 4.5.4, "ROM 
Pointers to Internal Information" on page 4-44). Refer to Appendix A for 
actual translate tables. 

6. Pointer to Terminal Translate Tables. 

This points directly to the start of the Terminal Translate Tables. The address 
of the default tables can be found at X ' 40E0 • (See 4.5.4, "ROM Pointers to 
Internal Information" on page 4-44). The following translate tables must 
appear sequentially in the following order, and must be of the following length: 

a. Normal ASCII Table (256 bytes) is used to convert a character from the 
IBM 7171 screen image buffer represented by internal extended ASCII 
code to normal ASCII code for output to the terminal. 

b. Normal ASCII Input Translate Table (128 bytes) . 

c. Typewriter Paired APL Table (256 bytes) is used to convert a character 
from the IBM 7171 screen image buffer represented by internal extended 
ASCII code to typewriter paired ASCII code for output to the terminal. 

d. Typewriter Paired APL Input Translate Table (128 bytes). 

e. Bit Paired APL Table (256 bytes) is used to convert a character from the 
IBM 7171 screen image buffer represented by internal extended ASCII 
code to bit paired ASCII code for output to the terminal. 

f . Bit Paired APL Input Translate Table (128 bytes) . 

g. Alternate Keyboard Input Translate Table (128 bytes). 

Note: For a description of the resident translate tables, see 
Appendix A, "ASCII and EBCDIC Data Conversion Tables." 

7. Pointer to Reset Character String. 

This word points to the start of a string of special keyboard reset characters 
which provide user control over error recovery and also define pacing protocol. 
The definition of this string is described in "Reset Character Keyboard 
Sequences" on page 4-9. 

8. Delay. 

This parameter makes it possible to specify the length, in milliseconds, of 
pauses between output strings being sent to the device. Delay causes tempo- 
rary suspension of character output to the terminal for a specified time. It is 
used when the terminal has limited buffer capability and may require time to 
perform an operation. 

9. Pointer to Set Graphic Rendition String. 

This word points to the start of a string defining the variable parameters in the 
graphic rendition control string for the terminal. This string is described in 
"Graphic Rendition Strings" on page 4-16. 

| 10. Terminal Screen Size Definitions. 

| This area consist of 8 bytes, one for each dimension. When left zero, row 

| dimensions default to 24, column dimensions to 80. 

| Default Physical (Terminal) Rows 
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Default Physical (Terminal) Columns 
Default Logical (3270) Rows 
Default Logical (3270) Columns 
Alternate Physical (Terminal) Rows 
Alternate Physical (Terminal) Columns 
Alternate Logical (3270) Rows 
Alternate Logical (3270) Columns 

That is all of the positional data required. All of the necessary data is now identi- 
fied via the above pointers. The CSS pointers and strings usually appear imme- 
diately following the header information. 

Let us look at the first eighteen bytes of the IBM3101 TDT as an example. It is 
found at address X ' DC00:4000 ' . In our example, the address at X ' DC00:4000 • 
is assumed to be X ' 5402 * . The eighteen bytes found at this address are: 

00 00 5E 54 14 54 20 00 6E 43 82 4D 82 52 00 00 8B 52 

This information tells us the following: The terminal flags are zeros. The first level 
input parse table is at address X ' 545E ' . The list of CSS pointers is found at 
X ' 5414 ' . The cursor base is X ' 0020 ' . The list of host translate tables is found 
atX'436E'. The terminal translate tables are found at X * 4D82 ' . The reset 
character string is found at X ' 5282 ' . There is no delay, and the SGR string is 
found at X ' 528B ' . Since the terminal flags do not indicate an extended format 
TDT, there is no screen size information. All row values default to 24, and all 
column values default to 80, i.e., a 327X Model 2 emulation. 

CSS Pointers and Strings: The third word of the terminal header information points 
to the first byte of the 19 CSS pointers. Each of the 19 entries is the address of the 
first byte of the given CSS. The addresses for all must exist, even if the string is 
not used. The addresses appear in this order: 

1 . Cursor Reposition String 

2. Erase to End Of Line 

3. Local Print 

4. Tone 

5. Cursor Left 

6. Cursor Right 

7. -- Unused ~ 

8. ~ Unused -- 

9. Signal Insert Mode On 

10. Signal Insert Mode Off 

11. Disconnect 

12. Clear 

13. Terminal Initialize 

14. Illegal ASCII Character 

15. Illegal APL Character 

16. APL Characters On 

17. APL Characters Off 

18. Display Mode 

19. Alternate Clear 

The length of each Control Sequence String is limited to 32 characters with the 
exception of the Terminal Initialize string, which may be up to 256 bytes long. 
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Each string starts at the address given in the above list of pointers and is terminated 
by X ' FF ' . The bytes that appear in the CSS are sent to the terminal as they exist 
in memory, with the following exceptions: 

X ' FF * There will be some strings, such as those that are unsupported, which 

should be NULL. In these cases, the pointers should point directly to the 
CSS terminating byte, X ' FF • . 

X ' FE ' This is used in a Cursor Position String to indicate where a binary * x ' or 
column position goes. The column is added to the cursor base, and sent 
instead of this byte. 

X ' FC ' This is used in a Cursor Position String to indicate where a binary ' y ' or 
row position goes. The row is added to the cursor base, and sent instead of 
this byte. 

X ' FA ' This is used in a Cursor Position String to indicate where a character mode 
1 x ' or column position goes. The cursor base is added to the column 
number, and the ASCII string representing the hex byte is sent to the ter- 
minal. 

X ' F8 ' This is used in a Cursor Position String to indicate where a character mode 
1 y ' or row position goes. The cursor base is added to the row number, and 
the ASCII string representing the hex byte is sent to the terminal. 

X ' F6 ' This is used in a Cursor Position String to indicate that a user supplied 
cursor x-positioning routine (USERX) will be called. 

X ' F4 * This is used in a Cursor Position String to indicate that a user supplied 
cursor y-positioning routine (USERY) will be called. 

X ' F2 ' This indicates that a delay will occur equal to the number of milliseconds 
specified in the terminal header delay parameter. 

X ' FO ' This is used in a Cursor Position String for a terminal type such as 

TYPETERM to indicate that cursor positioning should be approximated for 
a hardcopy device. 

X ' EE ' This is used in a Display Mode String to select the binary method of proc- 
essing the Set Graphic Rendition data for this terminal type. 

X ' EC ' This is used in a Display Mode String to select the character method of 
processing the Set Graphic Rendition data for this terminal type. 

For instance, if the characters "ESC" "[" row column were to be sent to the ter- 
minal for one CSS, the string might look like this: 

IB 5B FC FE FF 

If the command was to move the cursor to row 4 and column 5 and the cursor base 
was X * 0020 ' , the following string would be sent to the terminal: 

IB 5B 24 25 
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Input Parse Table: Keyboard input processing is driven by a syntax table called the 
Input Parse Table. The overall input parse table is divided into a main table and 
one or more next character lookup subtables associated with each alternative pos- 
sible in the left to right processing of the input character stream. 

The main table will also be called the first level input parse table. A subtable that 
can be reached directly from the main table will be called a second level input parse 
table; one that is reached from a second level table will be called a third level input 
parse table, and so on. 

Each entry in a parse table is a series of 4 bytes which is called a node. When a 
character is dequeued from the input typeahead buffer, the first byte of each node 
in the current parse table is searched until the first byte either matches the input 
character or matches one of four special bytes. When a character match is found, 
the action field of the node (the third and fourth bytes) are scanned to determine 
what action to take. When a special symbolic match is made, the action is one of 
the following: 

• Signal invalid end with a beep at the terminal. 

• Proceed with the table search using the byte to identify the search mode. This 
additional capability is provided to reduce parse size and is described in the fol- 
lowing sections. 

The nodes may be described using the following pseudocode. The pseudocode 
notation has the following form: 

[label] char [ ,param] action target [(routine)] 

label This term is optional. It is symbolic, and stands for a definition of the 

address at which the label appears. 

char This term represents the ASCII characters which are being searched or 

one of four symbolic names which identify additional search mode 
activity. A list of ASCII character names and their hex values are 
found in Figure 4-6 on page 4-39. The four symbolic names and 
their hex values are: 

END Stands for X'FF' 
OTHERS Stands for X • FE ' 
INDEX Stands for X'F8' 
MATCH Stands for X ' FA ' 

The function of END and OTHERS is given here while the function of 
MATCH and INDEX are described later in this chapter. 

END This signals the end of a subtable. When this character is 

found, the parse is invalid and a beep is generated at the 
terminal. Each subtable must end with the END byte. 
By convention, the address field of an END node points 
to itself. 

OTHERS This indicates that a different subtable should be 

searched. When this match is made, the target field of 
the node points to a subtable which is searched imme- 
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diately, using the same input character. OTHERS is a 
good tool for tying tables together. For example: 



TYPPFK 



OTHERS 


GOTO TYPPFK 


ai 


CALL PFK1 


5)2 


CALL PFK2 



When two tables end in a long string of common matches, 
the first table can simply transfer control using OTHERS 
to the common ending table. Thus in this example, when 
OTHERS GOTO TYPPFK is encountered, the input 
scan leaves the current table and resumes the character 
matching process starting at the TYPPFK node. 

The reader may wish to come back to this example after 
reading the rest of this section. 

param This optional term is the parameter that is to be passed to the routine. 

Byte one of each node provides a parameter value to be stored for 
transmission to a routine. If the parameter is zero, the current param- 
eter is not changed. Whenever a nonzero parameter is found, it is 
stored in the Data Control Block for that device. The parameter is 
then used by the routine to determine a course of action. For 
example, the ATTENTION routine uses the parameter to determine 
which attention key was pressed. For a complete list of possible 
parameters to pass to routines, see 4.5.3, "Parameters to Pass to IBM 
7171 Routines" on page 4-42. 

action This indicates the action that is to be taken following a character 

match of byte zero of the node. The action will be either GOTO or 
CALL. CALL indicates that a complete string was parsed correctly, 
and gives the routine to call. GOTO indicates that control is to be 
passed to another search list, and that the parse will continue. 

If a CALL is specified, byte three is null and byte two provides the 
routine number, which is an index into an internal routine lookup table 
for the entry point of the routine requested. See Figure 4-7 on 
page 4-40 for a list of available routine numbers. 

If a GOTO is specified byte three of the node is not null. Then bytes 
two and three form an address with a pointer to a next level input 
parse table, or a pointer to the special MATCH and INDEX strings. 

target This is a symbolic way of specifying either the number of the routine 

to call, a pointer to the address of the next level parse table to search, 
or a pointer to an address of a MATCH or INDEX string. 

routine This optional term is a comment to tell the reader what routine is indi- 

cated. It has no bearing on any byte values in the four byte entry. 

Thus the pseudocode represents four bytes of IBM 7171 storage which has the 
form: 
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Byte Character or process indication byte (char) 

Byte 1 Parameter Value (param) 

Bytes 2-3 Address of next parse table or routine number to call (target) 

Note: The input parse table does not parse the reset characters that are separately 
processed (Keyboard Reset, XON-XOFF, etc.) and described in "Reset Character 
Keyboard Sequences" on page 4-9. 

When the user is typing in simple graphic characters (blank X * 20 ' to tilde 
X ' 7E ' ), there is no need to refer to any table. The character is simply deposited 
in the internal screen image buffer at the current cursor position. When a control 
character is encountered, the first level input parse table is examined to determine 
what action should be taken. 

A sample first level IBM3101 input parse table is: 



IBM3101I 


ESC 


GOTO IBMESC 


DC00:545E 


1B 00 82 54 




HT 


CALL TAB 




09 00 0A 00 




BS 


CALL ENTER 




08 0A 02 00 




CR 


CALL NL 




0D 00 0B 00 




DEL 


CALL DELETE 




7F 00 09 00 




SYN 


CALL RESHOW 




16 00 0E 00 




VT,80 


CALL DPFM 


(dup char) 


0B 80 13 00 




FF,7F 


CALL DPFM 


(fm char) 


0C 7F 13 00 




END 


GOTO * 




FF 00 80 54 



Figure 4-4. First Level Input Parse Table for the IBM3101 TDT. 

In this description of the input parse tables each node is described in two ways: 

1. The pseudocode description. 

2. A hex representation of the bytes indicated by the pseudocode. Some nodes 
are prefixed by the address of the node. 

All IBM 3101 control keys either transmit a single control character 
(HT,BS,CR,DEL,SYN,VT,FF) or a compound sequence beginning with ESC. The 
first entry in the table shown above identifies the ESC introducer. It specifies, 
using the GOTO parameter, that it is part of a control string which continues in the 
subtable whose address is labelled IBMESC (see below). 

The next 7 entries define single control character requests which in themselves con- 
stitute a control request. Local functions are invoked when a parse subtable node 
matches a specific character and includes the CALL form. The valid routine names 
for CALL and the pertinent keyboard functions they invoke are specified in 
Figure 4-7 on page 4-40. 

The last entry is an END value which is used to signal the end of the subtable. 
Failure to include the END in a parse subtable will permit the syntax scan to "fall 
through" into the characters of the next table that follows sequentially, which will 
cause unpredictable results. 
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PARAM Field 



Most of the other IBM 3101 control keys produce a two character sequence begin- 
ning with the ESC control character. The parse subtable for these keys is shown in 
Figure 4-5 on page 4-36. 



IBMESC 


J 


GOTO 


IBMESC2 


DC00:5482 


4A 


00 


B6 


54 




HT 


CALL 


COLTAB 




09 


00 


1C 


00 




CR 


CALL 


COLBAK 




0D 


00 


1D 


00 




A 


CALL 


UP 


(cursor up) 


41 


00 


05 


00 




B 


CALL 


DOWN 


(cursor down) 


42 


00 


06 


00 




C 


CALL 


RIGHT 


(cursor right) 


43 


00 


04 


00 




D 


CALL 


LEFT 


(cursor left) 


44 


00 


03 


00 




H 


CALL 


HOME 


(home) 


48 


00 


0D 


00 




I 


CALL 


EEOF 


(erase eof/eol) 


49 


00 


OC 


00 




K 


CALL 


CURSEL 


(erase input) 


4B 


00 


11 


00 




L,4 


CALL 


ATTN 


(clear) 


4C 


04 


02 


00 




W 


CALL 


LPRT 


(print) 


57 


00 


08 


00 




END 


GOTO 


* 




FF 


00 


B4 


54 



Figure 4-5. Second Level Input Parse Table for the IBM3101 TDT. 

The Cursor Right key on the IBM 3101 sends the two character sequence ESC C. 
When the ESC character is received the first level parse table is scanned. The 
character matches the node in the table which specifies GOTO IBMESC. A 
GOTO node terminates the processing of the current character and stores the 
named label as the starting point for the scan to match the next character received. 
When the C is received, it is matched to the CALL RIGHT node in the second 
level input parse table. This terminates the control string and calls the "Cursor 
Right" routine to perform the selected function. 

If the sequence ESC,J,Z is encountered, the ESC would cause the scanning to be 
continued in the second level input parse table IBMESC. The J character will then 
be found in this table and will cause the third level input parse table IBMESC2 to 
be entered, where scanning will continue for the character Z. 



The PARAM field is used only by the routines ATTN, SET, RESET, DPFM, 
DEFER, and MULT. However, the parameter does not necessarily have to be 
specified on the final node. For example, suppose one also wished to use the eight 
native IBM 3101 Program Function Keys and identify them with PF keys 1-8 on 
the emulated 3270. This could be done by adding eight additional nodes to the 
second level input parse table which is entered when ESC has been encountered as 
the first character of an input character sequence. 



LCA,pfl 
LCB,pf2 
LCC,pf3 
LCD,pf4 
LCE,pf5 
LCF,pf6 
LCG,pf7 
LCH,pf8 



GOTO PEND 
GOTO PEND 
GOTO PEND 
GOTO PEND 
GOTO PEND 
GOTO PEND 
GOTO PEND 
GOTO PEND 



Then, if all four possible termination characters are to be supported, a final table in 
the following form would be needed: 
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PEND 



CR 


CALL, 


r ATTN 


ETX 


CALL, 


r ATTN 


EOT 


CALL, 


r ATTN 


XOFF 


CALL, 


r ATTN 


END 


GOTO, 


,* 



The first subtable entries will cause the PARAM value of the appropriate PF key to 
be stored in a control block, but the actual call to the ATTN routine will be 
deferred for one more characters. Thus, the next to last character is the character 
which determines which PF key was pressed. 

Note: If the XOFF is used as a termination character then it can not be used as 
pacing off in the Reset Character Keyboard String. 

DEFER: By calling the special DEFER routine, the same thing can be done for 
other non- Attention generating keys. Assume, for example, it was decided to use 
the IBM 3101 PF8 key as a Backtab. The relevant entry in the second level table 
would be: 

LCH.X'OF' GOTODEND 

The byte X ' OF ' is the routine number for Backtab and is determined from 
Figure 4-7 on page 4-40. The final PF key terminator table would consist of 
entries in the form: 

DEND CR CALL DEFER 

etc. 

The DEFER routine looks up the X ' OF ' parameter in the control block and exe- 
cutes the requested function. 



The Functions INDEX and MATCH 



With only the previously documented node forms, terminal tables typically need 
long sequences of entries which are identical in form, changing only the matching 
character and parameter. For example, the 36 possible PF key values require 36 
consecutive entries (and sometimes a second set of 36 values for the same keys 
shifted). To reduce the space which this occupies and simplify table generation, 
two functions called INDEX and MATCH may be used in byte zero of the node 
statement. 

INDEX and MATCH are functions which generate different parameter values 
given different inputs. The input to an INDEX or a MATCH is the next character 
in the input stream. Since the target field (bytes two and three) of the node state- 
ment is used to identify the address of an INDEX or MATCH string, a second 
node is always coupled with the INDEX or MATCH and is used to determine the 
action and target field if a correct identification is found in the INDEX or MATCH 
functions. This second node takes the form: 

null,param call routine 

or 
null,param goto subtable 

If a correct identification is not made within the MATCH or INDEX, then both 
nodes are passed over in the search list. 



Chapter 4. Customizing IBM 7171 Tables 4-37 



Index: The target field of the INDEX node points to a list of characters. The list is 
terminated by the byte X ' FF ' . The list of characters is searched for the input 
character. If the input character is found in the list, the zero based index of the 
matched character relative to the beginning of the list is added to the parameter in 
the INDEX node, and the routine given in the coupled node is called with the new 
parameter. For instance, assume the input character was a X ' 3 1 ' , and the fol- 
lowing nodes were found in the search list: 

INDEX GOTO CHARLIST 
NULL CALL ATTN 

Assume also that CHARLIST pointed to the following list of characters: 

2F30 31 32 FF 

The character X ' 3 1' would match the X • 3 1 ' in the target list, CHARLIST. The 
zero based index of the match, 2, would be added to the parameter in the node. 
The resulting parameter, 2, would then be passed to the ATTN routine. If the 
input character is not found in the list, it is treated as a non-match, and the parse 
continues as usual, skipping both the INDEX and the NULL nodes. 

Match: Match is very similar to Index. The target string for Match, however, is a 
series of pairs of values. The first character in the pair is the character to match, 
the second is a parameter value to be added. If the character is matched, instead of 
adding the index of the character that was matched, the value of the byte imme- 
diately following the matched character (the second byte of the pair) is added to 
the parameter. For instance, assume we had the same input character, X ' 3 1 ' , and 
the following nodes were found in the search list: 

MATCH,7 GOTO MATCHLIST 
NULL CALL ATTN 

Assume also that MATCHLIST pointed to the following list of characters: 

2F31 30 05 3106 32 07 FF 

The first character in each pair is examined for a match. In this case, the fifth byte 
is matched. The byte immediately following it, X ' 06 ' , is added to the parameter 
found in the MATCH statement, 7, and the result is passed on to the routine in the 
next node statement. In this case, ATTN would be called with a parameter of 
X'0D\ 

Many different terminals have quite similar requirements. First, some tables repre- 
sent the same terminal with minor differences in keyboard assignments (e.g., which 
key is ENTER and which is Newline). Some tables are based on modest differ- 
ences between several models of the terminal, or among options on the same model 
or microcode levels. Many terminals emulate other brands of terminals, but with 
improvements. 

Using the above functions (INDEX, MATCH, DEFER, and OTHERS), one could 
create very condensed TDTs that could function for several very similar terminals. 
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4.5 ASCII Character and Function Name Tables 



While building the TDT source file, it may be helpful to refer to the following 
tables. 



4.5.1 ASCII Character Name Table 



The following table assigns a unique name to each 7-bit ASCII character. These 
names will be used when specifying an ASCII character in the terminal definition 
tables. 



00 NULL 


20 


SPACE 


40 


AT 


60 


ACCENT 


01 SOH 


21 


EXCLAIM 


41 


A 


61 


LCA 


02 STX 


22 


DQUOTE 


42 


B 


62 


LCB 


03 ETX 


23 


POUND 


43 


C 


63 


LCC 


04 EOT 


24 


DOLLAR 


44 


D 


64 


LCD 


05 WRU 


25 


PERCENT 


45 


E 


65 


LCE 


06 ACK 


26 


AND 


46 


F 


66 


LCF 


07 BEL 


27 


QUOTE 


47 


G 


67 


LCG 


08 BS 


28 


LPAREN 


48 


H 


68 


LCH 


09 HT 


29 


RPAREN 


49 


I 


69 


LCI 


0A LF 


2A 


STAR 


4A 


J 


6A 


LCJ 


0B VT 


2B 


PLUS 


4B 


K 


6B 


LCK 


0C FF 


2C 


COMMA 


4C 


L 


6C 


LCL 


0D CR 


2D 


MINUS 


4D 


M 


6D 


LCM 


0E SO 


2E 


PERIOD 


4E 


N 


6E 


LCN 


OF SI 


2F 


SLASH 


4F 


O 


6F 


LCO 


10 DLE 


30 


so 


50 


P 


70 


LCP 


11 XON 


31 


31 


51 


Q 


71 


LCQ 


12 DC2 


32 


32 


52 


R 


72 


LCR 


13 XOFF 


33 


33 


53 


S 


73 


LCS 


14 DC4 


34 


34 


54 


T 


74 


LCT 


15 NAK 


35 


35 


55 


U 


75 


LCU 


16 SYN 


36 


36 


56 


V 


76 


LCV 


17 ETB 


37 


37 


57 


W 


77 


LCW 


18 CAN 


38 


38 


58 


X 


78 


LCX 


19 EM 


39 


39 


59 


Y 


79 


LCY 


1A SUB 


3A 


COLON 


5A 


Z 


7A 


LCZ 


1B ESC 


3B 


SEMI 


5B 


LBRACK 


7B 


LBRACE 


1C FS 


3C 


LESS 


5C 


BSLASH 


7C 


BAR 


1D GS 


3D 


EQUAL 


5D 


RBRACK 


7D 


RBRACE 


1E RS 


3E 


GREATER 


5E 


UPARROW 


7E 


TILDE 


1F US 


3F 


QUESTION 


5F 


UNDER 


7F 


DEL 



Figure 4-6. ASCII Character Name Table 
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4.5.2 Function Name Table 



The following table gives a unique name to each function that can be invoked by 
pressing a key or key sequence on the keyboard of an ASCII terminal. The 3270 
and IBM 7171 extended functions correspond to internal IBM 7171 names of sub- 
routines which will be called from the input parse table to execute those particular 
functions. Figure 4-7 lists these internal names, together with a more descriptive 
function notation. 



Routine 


Routine 


Routine 


Number 


Name 


Description 


X'08' 


LPRT 


Echoback Local Print Sequence 


X'13' 


DPFM 


Special Character (DUP or FIELD MARK) 


X*11 ' 


CURSEL 


Cursor Select (emulate light pen) 


X'OE 1 


RESHOW 


Redisplay Screen Contents 


X' 12' 


EINP 


Erase Input 


X'OC 


EEOF 


Erase EOF 


X'09' 


DELETE 


Delete Character 


X'07' 


INSRT 


Toggle Insert Mode 


X'OA' 


TAB 


Field Tab 


X'OF 1 


BTAB 


Field Backtab 


X' 1C' 


COLTAB 


Column Tab 


X 1 1D' 


COLBAK 


Column Backtab 


X* 1E' 


INDENT 


Indent 


X' 1F' 


UNDENT 


Undent 


X'02' 


ATTN 


Attention Generating (needs parameters 
for: ENTER, CLEAR, PF1 - PF36, 
PA1 - PA3, TREQ) 


X'OB' 


NL 


Newline 


X'OD 1 


HOME 


Home 


X'05' 


UP 


Cursor Up 


X'06 ? 


DOWN 


Cursor Down 


X'04' 


RIGHT 


Cursor Right 


X'03' 


LEFT 


Cursor Left 


X'17' 


SETTAB 


Set Column Tab 


X'1A* 


DELTAB 


Delete Column Tab 


X' 19' 


SETMRG 


Set Left Margin 


X' 1B' 


SETHOM 


Set Home Line 


X' 18' 


CLRTAB 


Delete All Column Tabs, Home Line, and 
Left Margin 


X'20 ? 


SET 


Set Mode of Operation (needs parameters 
for: z, n, e, c, v, d, i) 


X'21 ' 


RESET 


Reset Mode of Operation (needs 

parameters for: Z, N, E, C, V, D, I) 


X' 14' 


APLON 


APL Mode On 


X'16' 


APLOFF 


APL Mode Off 


X*15' 


APLEND 


ASCII Input in APL Mode 


X'22' 


PCON 


Restore Pacing 


X'23' 


PCOFF 


Suppress Pacing 


X'25' 


DISC 


Keyboard Initiated Line Drop 


X'26' 


INIT 


Return to ENTER TERMINAL TYPE Message 


X'27' 


ALTK 


Alternate Keyboard Arrangement 


X'28' 


MULT 


Multiple Key Input Sequence to Graphic 
Character 


X'2C 


RUBOUT 


Destructive Backspace 


X'2F' 


PGUP 


Page Up on Logical Screen 


X'30' 


PGDN 


Page Down on Logical Screen 


X' 10' 


DEFER 


Deferred Key Execute 



Figure 4-7. Function Name Table 
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For a more detailed description of the 3270 and IBM 7171 extended functions 
refer to 3.1, "IBM 3270 Emulated and Extended Functions" on page 3-1. Most 
of the entries in Figure 4-7 are self explanatory. Those functions requiring addi- 
tional clarification are discussed briefly below: 

ATTN refers to any Attention generating 3270 key except CURSOR 

SELECT. CURSOR SELECT is given a separate assignment 
because, while certain kinds of light pen sensitive fields do generate 
Attentions, others only toggle the Modified Data Tag. A fourth posi- 
tional parameter must be provided with CALL ATTN to define pre- 
cisely which Attention generating key has been recognized. 

DEFER is used when several keys generate sequences in which the beginning 
and ending characters are common and a middle key is the significant 
discriminator. An example of this are the IBM 3101 native PF keys 
(alternate functions of keys on the numeric pad). They all send a 
three character sequence beginning with ESC and ending with one of 
four optional change of direction characters (of which normally CR 
will be chosen). The IBM 7171 knows what function is being 
requested when the middle character arrives, but it must wait until the 
trailing character is received. An example is provided in "Input Parse 
Table" on page 4-33. 

DPFM allows a control key sequence to be turned into a special graphic char- 

acter. There are two such 3270 characters, DUP and FM, which act in 
many ways like graphic characters but are transmitted to the host as 
control characters. When a "CALL DPFM" statement is encount- 
ered, the PARAM field contains a one byte value of X ' 80 * for the 
DUP character, and X * 7F ' for the FM character stored in the current 
screen image at the current cursor position, subject to all the rules for 
protected fields and insert mode that apply to graphic characters. 

SET 

RESET are used to turn one of 16 special setup bits on and off. The bit 

number (0-15) is provided as the parameter to the SET and RESET 
functions. See 4.5.3, "Parameters to Pass to IBM 7171 Routines" on 
page 4-42 for a list of the parameters. Refer to Chapter 3, "Using 
ASCII Terminals on the IBM 7171" on page 3-1 for a more detailed 
description of these functions. 



PCON 
PCOFF 

ALTK 



control recognition of the pacing characters defined by the RCHR 
string. When pacing characters are not recognized, they are treated 
normal input. 



as 



selects an alternate keyboard arrangement based on the parameter 
value. Two keyboard arrangements are defined. When the parameter 
is (or is omitted), the standard typewriter (QWERTY) keyboard 
arrangement is selected. When the parameter is 1, the Dvorak key- 
board arrangement is selected. Refer to Chapter 3, "Using ASCII 
Terminals on the IBM 7171" on page 3-1 for a more detailed 
description. 
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MULT allows an input key sequence to be turned into a user defined graphic 

character. See item 1 on page 4-64 where an example of coding this 
function begins. 

RUBOUT is a destructive backspace function. If the cursor can move to the left 
and remain in an unprotected field, then the character at that location 
will be deleted. Any attempt to rubout a character in a protected field 
or an attribute byte will result in a warning beep. 

PGUP is a function used to page up on a logical screen which cannot be dis- 

played on the physical ASCII terminal because it has a smaller screen 
size than the 3270 device being emulated. If the screen has been 
paged up as far as possible, an audible alarm ("beep") will sound. 

PGDN is a function used to page down on a logical screen which cannot be 

displayed on the physical ASCII terminal because it has a smaller 
screen size than the 3270 device being emulated. If the screen has 
been paged down as far as possible, an audible alarm ("beep") will 
sound. 



4.5.3 Parameters to Pass to IBM 7171 Routines 

Following is a list of all possible parameters to pass to IBM 7171 routines: 



Routine 


Parameter 


Meaning 


DPFM 


X'80' 
X'7F' 


Character is a DUP 
Character is a FM 


ALTK 


1 



Select DVORAK keyboard 
Select QWERTY keyboard 


DEFER 


routine 


The calling of a routine was deferred. The parameter 
indicates the routine that was intended. 


ATTN 


1 

2 

3 

4 

6 

8 

9 

10 

11 

12 

46 


PAl was the ATTN Generating Key 

PA2 

PA3 

Clear 

Test Request 

Cursor Select 

Status Message Identifier 

Enter 

PFl 

PF2 

PF36 



Figure 4-8 (Part 1 of 2). Possible Parameters to Pass to Routines 
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Routine 


Parameter 


Meaning 


SET 



1 
2 
3 
4 
8 
9 


Enable Zones Mode 

3270 Null Processing 

Reverse Enter/Newline Keys 

Reverse Column/Field Tab Keys 

Allow Alphanumeric in Numeric Only Field 

Alternate Attribute Display 

3278 Insert Mode 


RESET 



1 
2 
3 
4 
8 
9 


Disable Zones Mode 

Improved Null Processing 

Restore Enter/Newline Keys 

Restore Column/Field Tab Keys 

Disallow Alphanumeric in Numeric Only Field 

Primary Attribute Display 

3277 Insert Mode 



Figure 4-8 (Part 2 of 2). Possible Parameters to Pass to Routines 
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4.5.4 ROM Pointers to Internal Information 



At the start of ROM, there is a list of addresses to all of the standard IBM 7171 
information. The following is an abbreviated list of that information. For a full 
description refer to Appendix E, "ROM Data Base Organization." The user is 
advised to use the information found here as often as possible. The addresses can 
be found using the Maintenance Facility, described in Chapter 9. 



Index 


Address 


Pointer 








8000 


4000 


Address 


of 


IBM3101 


TDT 


8001 


4002 


Reserved for future 


use 


8002 


4004 


Address 


of 


TVI912 


TDT 


8003 


4006 


Address 


of 


TVI920 


TDT 


8004 


4008 


Address 


of 


TVI950 


TDT 


8005 


400A 


Address 


of 


TVI950R 


TDT 


8006 


400C 


Address 


of 


ADM31 


TDT 


8007 


400E 


Address 


of 


ADM3A 


TDT 


8008 


4010 


Address 


of 


VT100 


TDT 


8009 


4012 


Address 


of 


DM1520 


TDT 


800A 


4014 


Address 


of 


DM1521 


TDT 


800B 


4016 


Address 


of 


DM3045 


TDT 


800C 


4018 


Address 


of 


TYPETERM 


TDT 


800D 


401A 


Address 


of 


HARDCOPY 


TDT 


800E 


401C 


Address 


of 


PLOTTER 


TDT 


8011 


4022 


Address 


of 


IBM316X 


TDT 


8012 


4024 


Address 


of 


ROLM3270 


TDT 


8021 


4042 


Address 


of 


Default ] 


^eset Character String 


8070 


40E0 


Address 


of 


List of ' 


rerminal Translate Tables 


8071 


40E2 


Address 


of 


List of ] 


-lost Translate Table 






Pointers 






8072 


40E4 


Address 


of 


Host Read Translate Table 


8073 


40E6 


Address 


of 


Input 1D 


Compound Formation Table 


8074 


40E8 


Address 


of 


3277 Basic Output Table 


8075 


40EA 


Address 


of 


Output 1D Compound Analysis Table 



Figure 4-9. ROM pointers 



4.6 Modifying or Adding TDTs Using the Maintenance Facility 



The instructions given in this section explain the use of the Maintenance Faculty to 
install a TDT. It is the installer's responsibility to generate the correct TDT infor- 
mation. As stated before, each TDT is terminal dependent. The user should refer 
to the terminal technical reference manual for each terminal type defined. The fol- 
lowing list is a brief summary of the steps necessary to install a new terminal type 
using the Maintenance Facility: 

1 . Define the TDT on paper first. 

The reason the TDT should be defined on paper first is that accuracy is essen- 
tial. Anything less than complete accuracy will cause unexpected and unpre- 
dictable events to occur. 
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The following information is necessary for a TDT: 

a. Terminal Header Information 

b. Keyboard Input Parse Tables 

c. Reset Character String 

d. Control Sequence Strings and Pointers 

e. Graphic Rendition Strings 

f . Screen Size Definitions. 

2. Refer to Chapter 9 for instructions about using the Maintenance Facility. The 
Maintenance Facility will be the tool used for making changes to NV-RAM. 

3. Insert the terminal name into the terminal names information area. 

4. Insert the TDT into NV-RAM. 

5. Update X ' DC00:0002 ' with the next available address in the NV-RAM. 



4.6.1 Terminal Names List 



The terminal names list is a group of records which may be arranged sequentially or 
in a linked list. The terminal names list begins at the Terminal Definition Table 
Area, X ' DC00:0300 ' . The terminal names list may be extended by a transfer 
field in a terminal name record if the next sequential storage area has been filled. It 
is the user's responsibility to ensure that the terminal names list does not contam- 
inate other data areas. To allow expansion of the names list, the user should leave 
two bytes of room for a transfer field at the end of the terminal names area. There 
are initially 16 terminal name records in the TDT Area. These terminals are 
described in Appendix B, "IBM 7171 Supplied Terminal Definition Tables." If 
the TDTs described do not include the definitions of all the terminals that will be 
connected to the IBM 7171, then the user will need to expand the terminal names 
list and add the appropriate TDTs. 

To expand the terminal names list, the following must be done: 

1. Find the end of the terminal names list. The user must scan the entire terminal 
names list which begins at X ' DC00:0300 ' . The user will need to understand 
the format of terminal name records (see below). 

2. Determine the storage needed for the new TDT. Each ASCII character 
requires one byte, and each pointer or optional field requires two bytes. 

3. Allocate the storage. The address of the first available byte can be found at 
address X ' DC00:0002 ' . To allocate the storage, add the number of bytes 
computed in step 2 to the value found at X ' DC00:0002 ' . Store the sum at 
address X ' DC00.0002 ' . 

4. Now enter the terminal name record. Store the terminal name and the address 
of its TDT. It is up to the user to remember to fill in these values when the 
values become known. If all the entries are first written out on paper it is pos- 
sible to derive the addresses the user will need at this point for the terminal 
names list. 

5. Make sure the terminal names list ends with two bytes of nulls, X ' 0000 ' . 
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Terminal Name Record Format 

The format of the terminal name record appears below. 



Terminal Name 


Pointer to 


Optional 




(eight bytes, 


TDT 






left justified, 


(two bytes) 


(This field is 


variable 


blank padded) 




length) 





The terminal name record has three fields. These are: 

Terminal Name 

The terminal name field is eight upper case ASCII characters long, left justified, 
and padded with blanks. 

TDT Pointer 

The second field is a word used to store the pointer to the first byte of the Ter- 
minal Definition Table. 

Optional 

The optional field can have zero, one, or more words. Each word in this field 
has the most significant bit (MSB) equal to one, with the exception that the list 
terminator has a value equal to X ' 0000 ' . The uses of these words are: 

• Signal that a carriage return is to be performed after this record's terminal 
name is printed. X ' FFFF ' is the code which identifies this use. 

• Signal that all terminal names following this record are to be hidden. 
X ' FFFE ' is the code which identifies this use. 

• Identify the address of the next record in the terminal names list. For this 
use the most significant bit equals one, and the high order byte is not equal 
to X ' FF ' . The address of the next record will be the 15 low order bits of 
the word (the hex value of the word minus X ' 8000 ' ). 

For example, suppose the optional Carriage Control word equals 
X ' 83F4 * . This means the next record can be found at address 
X'DC00:03F4\ 

• Start a new sublist by inserting the sublist separator, X ' FFFD * . 

• Terminate the terminal names list with X ' 0000 ' . This must be the last 
member of the terminal names list. 

Examples of Terminal Name Records 

These are hypothetical examples of terminal names records: 
1. ESSTTY1 9A03FFFF 

• The terminal's name is ESSTTY1 

• The terminal's TDT begins at X • DC00 : 03 9A • 

• Since the last two bytes are X ' FFFF ' there will be a carriage return after 
ESSTTY1 is printed. 
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2. T3A94 F204FFFE 

• The terminal's name is T3A94 

• The terminal's TDT begins at X ' DC00:04F2 ' 

• Since the last two bytes are X ' FFFE ' any terminal names after this record 
will be hidden. 

These examples explain the use of the Maintenance Facility to retrieve terminal 
name records from NV-RAM. 



1 . Here is an example of a fictitious terminal name record which happens to be 
the last record in the terminal names list. The terminal name is IBM3101 and 
we assume that the record begins at X ' DC00:0350 ' . 

Enter the following Maintenance Facility command: 

m DC00:0350 C 
This command gives this response: 

DC00.0350 4942 4D33 3130 3120 0080 0000 



Which the user should interpret as follows: 

X ' DC00 * = the segment address specified. 

X 1 0350 ' = the offset address specified. 

X'49' =1 

X'42' =B 

X'4D' =M 

X'33' =3 

X'31' = 1 

X'30' = 

X'31' = 1 

X'20' =ablank(SP) 

X ' 8000 ' = a ROM index to an address list which contains the address of 

the TDT. 

X ' 0000 ' = end of the terminal names list. 



The terminal name is IBM3101, left justified, blank padded. The TDT begins 
at the address which is at X ' DC00:4000 ' , and the optional field is a flag 
denoting the end of the terminal names list. 

2. Here is another example of a terminal names list. The terminal name record 
for an ESSAT1 is followed by the record for ESSAT2. After each name has 
been printed on the same line, there is a carriage return and a transfer field to 
the next record at X ' DC00:045C ' . The record begins at X ' DC00:036A • for 
this example. 

Enter the following Maintenance Facility command: 

mDC00:036A14 
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This command gives this response: 

DC00:036A 4553 5341 5431 2020 A20F 4553 5341 5432 
DC00:037A 2020 DCOF FFFF 5C84 

Which the user should interpret as follows: 

X ' DCOO ' = the segment address specified. 

X ' 03 6 A ' = the offset address specified. 

X'45' =E 

X'53' =S 

X'53' =S 

X'41' = A 

X'54' =T 

X'31' = 1 

X'20' =ablank(SP) 

X'20' =ablank(SP) 

X ■ 0FA2 ■ == the address of the first byte of ESSATl's TDT. 

X'45' =E 

X'53' =S 

X'53' =S 

X'41' = A 

X'54' =T 

X'31' =2 

X'20' =ablank(SP) 

X'20' =ablank(SP) 

X » OFDC ' = the address of the first byte of ESSAT2's TDT. 

X ' FFFF ' = carriage return after printing out terminal name. 

X ' 845 C ' = X ' 045 C ' is the address of the next record in the terminal 

name list. 

These terminal name records define two terminals, ESSAT1 and ESSAT2. The 
optional fields (the last two words) provide a flag indicating a carriage return 
should be printed after the terminal names, and a link to the remainder of the 
terminal names list. 

Examples of a Terminal Names List 

The following are examples of terminal names list: 

TNX - Denotes terminal name record X, where X equals some integer. 
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Example 1: 



TN1 


TN2 


TN3 



DC00:0300 

For example 1 , there are 3 terminal names records. Each defines a terminal name. 
The third record (TN3) also terminates the terminal names list. 

Example 2: 



TN1 


TN2 


TN3 




TN9 


TN10 


TN1 1 


TN12 



DC00:0300 



TN13 


TN14 


TN15 



DC00:05CB 

For example 2, there are 15 terminal name records. TNI 2 has a list transfer field 
which points to TN13. TNI 2 looks like this: 

58595 A3 130302020CC05FFFFCB85 

The terminal's name is XYZ100. Its TDT begins at X • DC00:05CC ' . After the 
terminal name is printed, a carriage return is printed. TN12's last two bytes are the 
address of the first byte of TNI 3 plus X • 8000 ' . TNI 5 is the end of the list. 
TNI 5 looks like this: 

414243393 1202020D20CFFFE0000 

This terminal's name is ABC91, its TDT begins at X ' DC00:0CD2 ' . All terminal 
names which appear after this record are hidden because of the optional carriage 
control sequence of X ' FFFE ' . The X • 0000 • at the end of TNI 5 denotes the end 
of the terminal names list. 

Examples of Entering Terminal Name Records 

This section provides examples of entering terminal name records. 

1. Suppose the end of the terminal names list is at X ' DC00:04A6 ' . The terminal 
name is ESS3A94, its TDT begins at X ' DC00:059A ' , and we want a carriage 
return after the name is printed. 
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Here are the Maintenance Facility commands to enter ESS3A94: 

sDC00:04A6 'ESS3A94' 
sw DC00:04AE 059A 
sw DC00:04B0 FFFF 
sw DC00:04B2 0000 

The user can look at the terminal names list just created by entering: 

m DC00:04A6 E 

The Maintenance Facility returns hex codes. In the example below a trans- 
lation has been done immediately below the hex code for the reader's conven- 
ience. 

DC00:04A6 4553 5333 4139 3420 9A05 FFFF 0000 

E S S3 A 9 4 SP 059A FFFF 0000 

Suppose the end of the terminal names list is at X ' DC00:063E ' , but there is 
not enough storage available in the terminal names record area to add another 
record. The following explains the steps necessary to add more terminal name 
records. First, find the address of the next available storage location. This is 
performed by checking at value at location X ' DC00:0002 ' , which contains 
this information. Check the contents of X ' DC00:0002 ' with this command: 

mw DC00:0002 

Which results in the following: 

DC00-.0002 066C 

The address X ' 066 C ' defines where the next terminal name record will be 
written. However, before the new record can be added, a link must be added. 
The link will be a list transfer field written over the previous end of terminal 
names list marker, X ' 0000 ' . To generate the proper link, add X ' 8000 ' to the 
address of the record being linked, X • 8000 ' + X ' 066C ' = X ' 866C • . Now 
write the list transfer field using the command: 

sw DC00:063E 866C 

This establishes a link to the new record. Now write out the new record or 
records. Be sure to terminate the terminal names list with a X ' 0000 ' . Finally 
update the next available address in NV-RAM at X ■ DC00:0002 ' . In this case 
the new value should be the address of the last byte in the terminal names list 
plus one. 
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4.6.2 Terminal Definition Tables, TDTs: 



This is a description of the TDTs which reside in NV-RAM. The description will 
be useful for users that intend to create their own tool for TDT generation, or users 
that need to understand the TDT data structure. The description uses a Pascal like 
pseudo language which is defined in the next section. The description is presented 
as an aid in generating TDTs. The pseudo definition language description is further 
developed by several block diagrams on the following pages. The definitions 
proceed in a top down fashion for both the pseudo definitions and the block dia- 
grams. 



Symbol Definitions for Pseudo Definition Language 



@ - a pointer to the data item described which implies a one word address 

: - denotes allocation of memory, byte, character, word, or pointer 

- implies a sequence, i.e. 1, 2, 3, .. 

; - a statement separator, 

= - equivalence, same as an assembler equate 

| - the select indicator, chose from the items on either side 

X - Hex Constant Prefix, i.e. X ' 6B ' 

' - Constant delimiter, open and close string, i.e. 'a' 

// - Concatenation operator, i.e. 'a'//'b' = 'ab' 



Key Words and Their Meanings for the Pseudo Definition Language 



ARRAY 

RECORD 

END 

BYTE 

WORD 

ASCII CHARACTER 



- A sequence of data objects not different from each 
other 

- An Aggregate of different related data objects 

- Terminator for the RECORD Key word 

- a Unit of storage consisting of 8 bits 

- a Unit of storage consisting of 2 bytes 

- a Unit of storage consisting of 8 bits, in the range 
X^'-X^F' 



Variable Naming Conventions 



PTR indicates the variable is a word which contains an address. The variable 
names in the type definitions are consistent with the TDT structures described in 
this manual. To get a complete understanding of each variable name, the user may 
need to refer back to different sections. 



Type 

TDT_TYPE = TERMINAL_HEADER; 

TERMINAL_HEADER IS RECORD 
STATUS_FLAG1 
STATUS_FLAG2 
PTR_PARSE_TABLE 
PTR_1ST_CSS_PTR 
CURSOR_BASE 

PTR_TO_HOST_TRANSLATE_TABLE_ADDRESS 
PTR_TO_TERM_TRANSLATE_TABLE 
PTR_TO_RESET_STRING 
DELAY 

PTR_TO_SET_GRPK_RENDITION_STRING 
DEFAULT PHYSICAL ROWS 



BYTE; 

BYTE; 

3PARSE_TABLE_TYPE ; 

3CSS_PTR_REC; 

WORD; 

3HOST_TRANSLATE_TABLE ; 

3TERM_TRANS_TABLE ; 

3RESET_STRING; 

WORD: 

aSGR 

BYTE 
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DEFAULT_PHYS I CAL_COLUMNS 
DEFAULT_LOGICAL_ROWS 
DEFAULT_LOGI CAL_COLUMNS 
ALTERNATE_PHYSICAL_ROWS 
ALTERNATE_PHYSICAL_COLUMNS 
ALTERNATE_LOGI CAL_ROWS 
ALTERNATE_LOGICAL_COLUMNS 
END; 



BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 



CSS_PTR_REC IS RECORD 

PTR_CURSOR_REPOSITION_STRING 

PTR_ERASE_END_OF_LINE 

PTR_LOCAL_PRINT 

PTR_TONE 

PTR_CURSOR_LEFT 

PTR_CURSOR_RIGHT 

UNUSED 1 

UNUSED2 

PTR_SIGNAL_INSERT_MODE_ON 

PTR_S IGNAL_INSERT_MODE_OFF 

PTR_DISCONNECT 

PTR_CLEAR_SCREEN 

PTR_TERMINAL_INITIALIZE 

PTR_ILLEGAL_ASCI I_CHARACTER 

PTR_ILLEGAL_APL_CHARACTER 

PTR_APL_CHARACTERS_ON 

PTR_APL_CHARACTERS_OFF 

PTR_DI SPLAY_MODE 

PTR_ALTERNATE_CLEAR_SCREEN 

END; 



acss 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 

acss" 



STRING 

"string 

STRING 

"string 
'string 
"string 
"string 
'string 
'string 
'string 
'string 
"string 
"string 
'string 
"string 
"string 
string 
'string 
"string 



(32) 

(32) 

(32) 

(32) 

(32) 

(32) 

(0) ; 

(0); 

(32) 

(32) 

(32) 

(32) 

(256) ; 

(32) 

(32) 

(32) 

(32) 

(32) 

(32) 



PARSE_TABLE_TYPE = PARSE_TABLE_NODE I 

PARSE_TABLE_NODE // PARSE_TABLE_TYPE ; 

PARSE_TABLE_NODE IS RECORD 
CHARACTER : BYTE; 
PARAMETER : BYTE; 
TARGET : WORD 
END ; 

CSS_STRING(I) IS RECORD 

SEQUENCE : VARIABLE LENGTH ARRAY [ 1 . . I ] OF 

SPECIAL_ASCII_CHAR; 
SEQ_TERMINATOR : X ' FF ' 
END; 

SPECIAL_ASCII_CHAR = X ' EC ' I X'EE' I X ' F0 * I X'F2' I X ' F4 ' | 

X'F6' | X'F8' | X'FA 1 I X ' FC * I X ' FE ' I 
ASCII CHARACTER; 



ASCII CHARACTER = X*00' I X'01' | X'02 1 I 



I X ' 7E ' | X ' 7F ' ; 



HOST_TRANSLATE 
PTR_READ_32' 
PTR_READ_32 
PTR_WRITE_3 
PTR_WRITE_3 
PTR_WRITE_3 
PTR_WRITE_3 
PTR_WRITE_3 
PTR_READ_32 
PTR_READ_32 
PTR_READ_32 
END; 



TABLE = RECORD 
77_ASCII2EBCDIC 
7 7_ATTRIBUTE_APL 
277_EBCDIC2ASCII 
2 7 7_ATTRIBUTE_APL 
278_EBCDIC2ASCII 
278_ATTRIBUTE 
278_APL 

78_ASCII2EBCDIC 
78_ATTRIBUTE 
78 APL 



3ARRAY [ 


1 . 


.256 


OF 


BYTE 


3ARRAY [ 


1 . 


.256 


OF 


BYTE 


3ARRAY [ 


1 . 


.256 


OF 


BYTE 


3ARRAY t 


1 . 


.256 


OF 


BYTE 


3ARRAY [ 


1 . 


.256 


OF 


BYTE 


3ARRAY [ 


1 . 


.256 


OF 


BYTE 


3ARRAY [ 


1 . 


.256 


OF 


BYTE 


3ARRAY [ 


1 . 


.256 


OF 


BYTE 


3ARRAY [ 


1 . 


.256 


OF 


BYTE 


3ARRAY [ 


1 . 


.256 


OF 


BYTE 
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TERM_TRANS_TABLE IS RECORD 
NORMAL_ASCI I_OUTPUT 
NORMAL_ASCI I_INPUT 
TYPEWRITER_PAIRED_OUTPUT 
TYPEWRITER_PAIRED_INPUT 
BIT_PAIRED_APL_OUTPUT 
BIT_PAIRED_APL_INPUT 
ALT_KEYBOARD_INPUT 
END; 



ARRAY [ 


1. 


.256 


] 


OF 


BYTE 


ARRAY [ 


1 . 


.128 


] 


OF 


BYTE 


ARRAY [ 


1 . 


.256 


] 


OF 


BYTE 


ARRAY [ 


1 . 


.128 


] 


OF 


BYTE 


ARRAY [ 


1 . 


.256 


] 


OF 


BYTE 


ARRAY [ 


1 . 


.128 


] 


OF 


BYTE 


ARRAY [ 


1 . 


.128 


] 


OF 


BYTE 



RESET STRING IS RECORD 






RESET INTRODUCER 


ASCII 


CHARACTER 


MASTER RESET 


ASCII 


CHARACTER 


CHARACTER ERROR RESET 


ASCII 


CHARACTER 


3270 RESET 


ASCII 


CHARACTER 


INPUT BUFFER FLUSH 


ASCII 


CHARACTER 


PACING START 


ASCII 


CHARACTER 


PACING STOP 


ASCII 


CHARACTER 


MAINTENANCE FACILITY 


ASCII 


CHARACTER 


END; 







SGR IS RECORD 

PRIMARY_NONDI SPLAY 

PRIMARY_NORMAL_INTENSITY_UNPROTECTED 

PRIMARY_HIGH_INTENSITY_UNPROTECTED 

PRIMARY_NORMAL_INTENSITY_PROTECTED 

PRIMARY_HIGH_INTENSITY_PROTECTED 

ALTERNATE_NOND ISP LAY 

ALTERNATE_NORMAL_INTENSITY_UNPROTECTED 

ALTERNATE_HIGH_INTENSITY_UNPROTECTED 

ALTERNATE_NORMAL_INTENSITY_PROTECTED 

ALTERNATE_HIGH_INTENSITY_PROTECTED 

END ; 



BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 
BYTE 



TDT TYPE 



TERMINAL HEADER 26 


decimal bytes 


CSS POINTERS 

38 


decimal bytes 


CSS STRINGS 

VARIABLE — 


dependent on type of terminal 


INPUT PARSE TBL 

VARIABLE — 


4 * number of input nodes 



The length of the TDT depends upon the type of terminal being used. However, all 
TDTs have a minimum fixed length of 64 decimal bytes. 
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TERMINAL HEADER — Fixed length of 26 decimal bytes 



STATUS FLAG1 - 1 byte 


STATUS FLAG2 


_ 


1 byte 




PTR TO INPUT PARSE TABLE 




2 


bytes 




PTR TO CSS POINTERS LIST 




2 


bytes 




CURSOR BASE 




2 


bytes 




PTR TO HOST TRANSLATE TABLE ADDRESS LIST 




2 


bytes 




PTR TO TERMINAL TRANSLATE TABLES 




2 


bytes 




PTR TO RESET CHARACTER STRING 




2 


bytes 




DELAY 




2 


bytes 




PTR TO SET GRAPHIC RENDITION STRING 




2 


bytes 




DEFAULT PHYSICAL ROWS - 1 byte 


DEFAULT 


PHYSICAL COLUMNS - 


1 byte 


DEFAULT LOGICAL ROWS - 1 byte 


DEFAULT 


LOGICAL COLUMNS - 1 


byte 


ALTERNATE PHYSICAL ROWS - 1 byte 


ALTERNATE 


PHYSICAL COLUMNS 


- 1 byte 


ALTERNATE LOGICAL ROWS - 1 byte 


ALTERNATE 


LOGICAL COLUMNS - 


1 byte 
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CSS Pointers — Fixed length of 38 decimal bytes. 



PTR CURSOR REPOSITION STRING 


2 bytes 


PTR ERASE END OF LINE 


2 bytes 


PTR LOCAL PRINT 


2 bytes 


PTR TONE 


2 bytes 


PTR CURSOR LEFT 


2 bytes 


PTR CURSOR RIGHT 


2 bytes 


UNUSED 1 


2 bytes 


UNUSED 2 


2 bytes 


PTR SIGNAL INSERT MODE ON 


2 bytes 


PTR SIGNAL INSERT MODE OFF 


2 bytes 


PTR DISCONNECT 


2 bytes 


PTR CLEAR SCREEN 


2 bytes 


PTR TERMINAL INITIALIZE 


2 bytes 


PTR ILLEGAL ASCII CHARACTER 


2 bytes 


PTR ILLEGAL APL CHARACTER 


2 bytes 


PTR APL CHARACTERS ON 


2 bytes 


PTR APL CHARACTERS OFF 


2 bytes 


PTR DISPLAY MODE 


2 bytes 


PTR ALTERNATE CLEAR SCREEN 


2 bytes 
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CSS — String lengths are variable. 



CURSOR REPOSITION ' FF ' 



ERASE END OF LINE ' FF 



LOCAL PRINT ' FF ' 



TONE 'FF 1 



CURSOR LFT ' FF ' 



CURSOR RT 'FF' 



SIGNAL INS MODE ON 'FF' 



SIGNAL INS MODE OFF ' FF ' 



DISCONNECT 'FF' 



CLEAR SCREEN ' FF 



ILLEGAL ASCII CHARACTER ' FF ' 



ILLEGAL APL CHARACTER 'FF 1 



APL CHARACTERS ON ' FF ' 



APL CHARACTERS OFF ' FF ' 



DISPLAY MODE ' FF ' 



ALTERNATE CLEAR SCREEN ' FF ' 



Input Parse Table. 



PARSE TABLE NODE 1 



4 bytes 



PARSE TABLE NODE 2 4 bytes 



PARSE TABLE NODE (i) 

each node is 4 bytes 



PARSE TABLE NODE N 4 bytes 



PARSE TABLE NODE I 



CHARACTER 1 byte 



PARAMETER 1 byte 



TARGET 1 word 



Entering a TDT 



This section describes entering a TDT using the Maintenance Facility. 

1. Enter the Maintenance Facility as described in Chapter 9. 

2. Get the address of the next available storage area in NV-RAM. This can be 
accomplished by using the Maintenance Facility command: 

mw DC00:0002 
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3. Allocate the terminal header area. This area is eighteen bytes in length and 
consists of two bytes for flags and eight words for pointers and parameters. 

4. Enter the terminal header information. 

Perform the following 10 steps, substituting the last parameter in each 
command with the described value, and performing the arithmetic before 
entering the command (i.e., enter X ' 04E6 ' in place of X ' 04E2 ' +4). 
X ' 04E2 ' is the example starting point. Use the value found at 
X ' DC00:0002 ' for the actual starting point. Refer to this chapter for 
descriptions of each terminal header parameter value. 

a. s DC00:04E2 Status_Flag__l 

b. sDC00:04E2+l Status_Flag_2 

c. sw DC00:04E2+2 PTR_to_Parse_Table_Entry_Address 

d. sw DC00:04E2+4 PTR__to__CSS_Pointer__List 

e. sw DC00:04E2+6 PTR_to_Cursor_Base 

f. swDC00:04E2+8 

PTR to Host_Translate__Table Address List 

g. sw DC00:04E2+A PTR_to_Terminal__Translate_Tables 
h. sw DC00:04E2+C PTR_to_Reset_Character_String 

i. sw DC00:04E2+E Delay 

j . sw DC00 : 04E2 + 1 PTR_to_Set_Graphic_Rendition_String 

k. sDC00:04E2+12 Default Physical Rows 

1. sDC00:04E2+13 Default Physical Columns 

m. sDC00:04E2+14 Default Logical Rows 

n. sDC00:04E2+15 Default Logical Columns 

o. sDC00:04E2+16 Alternate Physical Rows 

p. s DC00.04E2+ 17 Alternate Physical Columns 

q. s DC00:04E2+ 18 Alternate Logical Rows 

r. s DC00:04E2+ 19 Alternate Logical Columns 

5. Now allocate the CSS pointer area. This area is 38 bytes long and consists of 
19 words for pointers to Control Sequence Strings. 

Since storage is sequentially allocated, we can continue building our TDT after 
the terminal header area. 
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6. Enter the Control Sequence Strings. The strings pointed to by the 19 CSS 
pointers will stored after the CSS pointer area. It is important to keep an accu- 
rate count of every byte the user allocates as the CSSs are entered. 

For example, the first CSS pointer points to a string of characters that the ter- 
minal recognizes as the Cursor Reposition sequence. If we continue with our 
example from the terminal header area, we can see that bytes X ' 04E2 ' thru 
X * 04E2 ' + X ' 19 ' have been used by the terminal header area. The next 
address (X ' 04E2 • + X ' 1 A ' ) will be the first CSS pointer, which is a pointer 
to the Cursor Reposition sequence. The Cursor Reposition sequence will be 
stored in the first available area, which is after the CSS Pointer Area, 
X ' 04E2 ' + X ' 1 A ' + X • 26 ' . The Cursor Reposition sequence is terminated 
by the byte X ' FF ' . The second pointer in the CSS area is pointing to the 
Erase EOL sequence. The Erase EOL sequence is stored in the next available 
area, which is after the X ' FF ' byte which was used to terminate the Cursor 
Reposition sequence. The pointer to the Erase EOL sequence will be stored at 
X ' 04E2 ' + X ' 1C ' , and the actual character sequence representing Erase 
EOL will be at X ' 04E2 • + X ' 1 A ' + X • 26 ' + the length in bytes of the 
Cursor Reposition sequence + one for the length of the terminator. 

Please note the CSS terminator must be used to terminate each CSS. Without 
the terminator, the IBM 7171 will not send the correct sequence to the ter- 
minal. 

While the CSS pointers should be entered using the 'sw' command the CSS 
themselves should be entered using the 's' command. For example suppose we 
want the sequence: 

ESCG@ 

Look up the ASCII hex values for ESC, G, and @. The S command will store 
the string properly when entered as follows (XYZA is the appropriate offset): 

S DC00:XYZA 1B47 40FF 

Note the last byte is the CSS terminator. 

7. Enter the Input Parse Table. The Input Parse Table is the chief tool for 
decoding and correlating terminal keystrokes. Each keystroke or keystroke 
sequence is translated into a request for some specific action such as cursor 
movement, clear screen, home, etc. The format of the Input Parse Table is an 
aggregate of nodes. Each node defines the character and the action that 
should take place. Refer to "Input Parse Table" on page 4-33 for a more 
detailed description of the Input Parse Table. 

The Input Parse Table may follow the CSS area. Once you know the address 
of the first byte, you can fill in the Input Parse Table pointer which is in the 
TDT Terminal Header Record. Then you should fill in each node in the Parse 
Table which is exactly 4 bytes long. Each byte in the node must be specified. 
It is strongly recommended that the entire parse table be outlined on paper 
first. This will allow you to proceed with each entry of the table without having 
to keep track of unknown addresses which will not be known until later in the 
parse table description. 
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For demonstration purposes, we will describe the entering of one node of an 
Input Parse Table. Assume that you want to enter at the location 
X ' DC00:07A2 ' the node "ESC GOTO IBMESC." The sequence of Mainte- 
nance Facility commands to accomplish this is: 

s DC00:07A2 IB ;ESC=X'1B' 

s DC00:07A3 00 

sw DC00:07A4 5482 ;This the GOTO address IBMESC 

This node is equivalent to the first node in Figure 4-4 on page 4-35. Note 
that this figure contains a byte for byte representation of 7171 memory and 
that the GOTO address is stored in byte reversed notation. 

Whenever an address or pointer is read in a byte by byte manner, then any 
bytes that where written as a word are reversed with respect to their intended 
order. For example we could read in the parse table node we wrote out two 
ways: byte by byte or exactly the way it was written, namely 2 bytes and a 
word. 

For byte display, issuing the command: 

m DC00:07A1 4 
would display: 

DC00:07A1 1B00 8254 

The address is retrieved byte reversed. To retrieve exactly what was written 
we have to issue the following sequence of commands: 

m DC00:07A1 2 
mw DC00:07A3 

which would output: 

DC00:07A1 1B00 
DC00-.07A3 5482 

Add the terminal name to the Terminal Names List which begins at 
X'DC00:300\ 



Examples of Modifying Host Translate Tables 



Example 1: Here is an example of changing the host translate tables by copying 
areas of ROM into NV-RAM using the Maintenance Facility. The goal is to create 
a set of translation tables for 3278 emulation that change the EBCDIC upper case 
A to an ASCII lower case a, and EBCDIC lower case a to ASCII upper case A. 
The default 3278 emulation translate tables map the EBCDIC upper case to ASCII 
upper case, and the EBCDIC lower case to ASCII lower case. 

Here are the steps involved: 

1. To make this change smoothly, the user will need the 

HOST_WRITE_3278_EBCDIC_TO_ASCII table copied into 
NV-RAM. This table is 256 bytes long. The user will also need a copy of the 
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list of host translate table addresses which is 20 bytes long, and for this 
example, a copy of the terminal header which is the first 18 bytes of the ter- 
minal definition table (for an old style TDT. If the TDT has the extended 
format with screen size information, then the terminal header is 26 bytes long). 
The total amount of storage required for this example is 294 bytes of 
NV-RAM. For demonstration purposes, this storage will be allocated at offset 
X'lDOO'. 

2. Log onto the Maintenance Facility. 

3. Find the address of the host translate table addresses and the Terminal Defi- 
nition Table for the IBM3 101. 

ENTER : 

T IBM3101 

RESPONSE: 

All terminal offset values are relative to segment DC00: 

Address of Terminal Definition Table: 5402 

Flags: 0000 Input Parse Tables: 545E Output Parse Tables: 5414 

Cursor Base: 0020 Host Trans Tables: 436E Term Trans Tables: 4D82 

Reset Chars: 5282 Transmit Delay: 0000 Attribute Params: 528B 

Ok 

The host translate table addresses are at X ' 436E ' and the Terminal Definition 
Table is at X' 5402'. 

4. Get the address of the HOST_WRITE_3278_EBCDIC_TO_ASCII 
translate table (the length of the host translate tables address list is 20 bytes). 

ENTER: M DC00:436E 14 

RESPONSE: DC00:436E 8243 8244 8245 8246 8247 8248 8249 824A 

DC00:437E 824B 824C 

Ok 

The HOST_WRITE_3278_EBCDIC_TO_ASCII table, fifth in the list, 
begins at X' 4782'. 

5. Copy the HOST_WRITE_3278_EBCDIC_TO_ASCII table into 
NV-RAM. 

ENTER: CO DC00:4782 DC00:1D00 100 

RESPONSE: Ok 

6. Change the EBCDIC lower case a (X ' 81 V) translation to ASCII upper case A 
(X'41'). 

ENTER: S DC00: 1D81 41 
RESPONSE: Ok 

7. Change the EBCDIC upper case A (X ' C 1 * ) to ASCII lower case a (X ' 6 1 • ). 

ENTER: S DC00: 1DC1 61 
RESPONSE: Ok 

8. Copy the host translate table addresses to NV-RAM. 

ENTER: CO DC00 : 436E DC00 : 1F00 14 
RESPONSE: Ok 
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9. Change the pointer to the HOST_WRITE_3278_EBCDIC_TO_ASCII 
table. 

ENTER: SWDC00:1F08 1D00 

RESPONSE: Ok 

10. Copy the IBM3101 terminal header into NV-RAM. 

ENTER: CO DC00:5402 DC00:1F20 12 

RESPONSE: Ok 

11. Change the host translate table pointer. 

ENTER: SW DC00:1F28 1F00 
RESPONSE: Ok 

12. Change the pointer in the terminal names list for the terminal with the new 
translate tables (assuming the IBM3101 is the first terminal name in the list 
which begins at off set X ' 300 • ). 

ENTER: SW DC00:308 1F20 
RESPONSE: Ok 

13. Now to test the example, logon as a user, enter XEDIT, SET CASE MIXED, 
insert the following text on a line by itself, and file it as TEST CASE A. 

UPPER CASE - lower case 

14. Issue a CP IND command. Notice that the upper case A's appeared as lower 
case a's. 

15. Issue a TYPE TEST CASE command. Notice the upper case A appeared as a 
lower case a and the lower case a appeared as an upper case A. This is due to 
the translation the IBM 7171 makes. The host system sends a 3270 
datastream which contains only EBCDIC characters. Since the IBM 7171 
interfaces with ASCII devices, a translation must take place. In this example, 
the translation for an EBCDIC upper case A was changed from an ASCII 
upper case A to an ASCII lower case a, and the translation for the EBCDIC 
lower case a was changed from an ASCII lower case a to an ASCII upper case 
A. 

Note: The only table changed was the 
HOST_WRITE_3278_EBCDIC_TO_ASCII. 

16. Enter XEDIT TEST CASE, again SET CASE MIXED. 

17. Move the cursor over the -, then strike the - key followed by the ENTER key. 
The results should be an inversion of the upper and lower case A's. Try it 
several times. Try a the HEXTYPE command, notice if XEDIT thinks the A is 
upper or lower case. Strike the dash key as before. Try the HEXTYPE 
command again. 

18. To undo this translation, return to Maintenance Facility mode and change the 
pointer to the IBM3101 TDT back to X ' 8000 ' , or change the translation table 
back to normal. 
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Example 2: Here is an example of changing the host translate tables by copying 
areas of ROM into NV-RAM using the Maintenance Facility. The goal is to create 
a set of translation tables for 3278 emulation that change the backslash and vertical 
bar translations. The default 3278 emulation translate tables map the ASCII 
double bar to an EBCDIC single vertical bar, and the ASCII backslash to an 
EBCDIC cent sign. 

Here are the steps involved: 

1 . To make this change smoothly, the user will need the 
HOST_READ_3278_ASCII_TO_EBCDIC table and the 
HOST_WRITE_3278_EBCDIC_TO_ASCII table copied into 
NV-RAM. Each table is 256 bytes long. The user will also need a copy of the 
list of host translate table addresses which is 20 bytes long, and for this 
example, a copy of the terminal header which is the first 18 bytes of the ter- 
minal definition table (for an old style TDT. If the TDT has the extended 
format with screen size information, then the terminal header is 26 bytes long). 
The total amount of storage required for this example is 550 bytes of 
NV-RAM. For demonstration purposes, this storage will be allocated at offset 
X'lDOO'. 

2. Log onto the Maintenance Facility. 

3. Find the address of the host translate table addresses, and the Terminal Defi- 
nition Table for the IBM3101. 

ENTER: T IBM3101 

RESPONSE: All terminal offset values are relative to segment DC00: 
Address of Terminal Definition Table: 5402 

Flags: 0000 Input Parse Tables: 545E Output Parse Tables: 5414 
Cursor Base: 0020 Host Trans Tables: 436E Term Trans Tables: 4D82 
Reset Chars: 5282 Transmit Delay: 0000 Attribute Params : 528B 
Ok 

The host translate table addresses are at X ' 436E ' and the Terminal Definition 
Table is at X' 5402'. 

4. Get the address of the HOST_READ_3278_ASCII_TO_EBCDIC and 
the HOST_WRJTE_3278_EBCDIC_TO_ASCII translate tables (the 
length of the host translate tables address list is 20 bytes). 

ENTER: M DC00:436E 14 

RESPONSE: DC00:436E 8243 8244 8245 8246 8247 8248 8249 824A 

DC00-.437E 824B 824C 

Ok 

The HOST_WRITE_3278_EBCDIC_TO_ASCII table, fifth in the list, 
begins at X ' 4782 ' , and the HOST_READ_3278_ASCII__TO_EBCDIC 
table begins at X ' 4A82 ' , the eighth pointer of the list. 

5 . Copy the HOST_WRITE_3278_EBCDIC_TO_ASCII table into 

NV-RAM. 

ENTER: CO DC00:4782 DC00:1D00 100 
RESPONSE: Ok 
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6. Change the EBCDIC cent sign (X • 4A ' ) translation to internal code (X • 85 • ). 

ENTER: S DC00:1D4A 85 
RESPONSE: Ok 

7. Change the EBCDIC backslash (X ' EO ' ) translation to ASCII backslash 
(X'5C). 

ENTER: S DC00:1DE0 5C 
RESPONSE: Ok 

8. Change the EBCDIC vertical bar (X ' 4F • ) translation to internal code 
(X'86'). 

ENTER: S DC00:1D4F 86 
RESPONSE: Ok 

9. Change the EBCDIC double vertical bar (X ' 6A ' ) translation to ASCII back- 
slash (X'7C). 

ENTER: S DC00-.1D6A 7C 

RESPONSE: Ok 

10. Copy the HOST_READ_3278_ASCII_TO_EBCDIC table into 
NV-RAM. 

ENTER: CO DC00:4A82 DC00.-1E00 100 

RESPONSE: Ok 

1 1 . Change the ASCII backslash (X ' 5C ' ) to EBCDIC backslash (X ' EO ' ). 

ENTER: S DC00:1E5C EO 
RESPONSE: Ok 

12. Change the ASCII double vertical bar (X ' 7C ' ) to EBCDIC double vertical 
bar(X'6A'). 

ENTER: S DC00:1E7C 6A 
RESPONSE: Ok 

13. Change the internal code for cent sign and single vertical bar back to EBCDIC. 

ENTER: S DC00.-1E85 4A4F 
RESPONSE: Ok 

14. Copy the host translate table addresses to NV-RAM. 

ENTER: CO DC00:436E DCO0.-1FO0 14 

RESPONSE: Ok 

15. Change the pointer to the HOST_WRITE_3278_EBCDIC_TO_ASCII 
table. 

ENTER: SW DC00:1F08 1D00 

RESPONSE: Ok 

16. Change the pointer to the HOST_READ_3278_ASCII__TO_EBCDIC 
table. 

ENTER: SWDC00:1F0E 1E00 

RESPONSE: Ok 
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17. Copy the IBM3101 terminal header into NV-RAM. 

ENTER: CO DC00-.5402 DC00:1F20 12 

RESPONSE: Ok 

18. Change the host translate table pointer. 

ENTER: SWDC00-.1F28 1F00 

RESPONSE: Ok 

19. Change the pointer in the terminal names list for the terminal with the new 
translate tables (assuming the IBM3101 is the first terminal name in the list 
which begins at offset X ' 300 • ). 

ENTER: SW DC00:308 1F20 
RESPONSE: Ok 

This example is ready for testing. Return to the ENTER TERMINAL TYPE 
message, select the IBM3101 or the terminal which has the modified Host translate 
tables, and test the cases changed. 

To continue the example, suppose the cent sign is still required as an keyboard 
character. This can be accomplished by defining a control sequence and invoking 
the MULT function, see 4.5.2, "Function Name Table" on page 4-40. 

Here are the steps to define a MULT input sequence: 

1. Choose a unique control sequence. For this example, X ' 15 ' , will be used. A 
X' 15 ' can be generated on an real IBM3101 by entering "ALT-U" or on the 
IBM PC emulating an IBM3101 by pressing "CTRL-U." 

2. Create a parse table node, see "Input Parse Table" on page 4-33 for help with 
input parse nodes. 

a. The character to match is X ' 15 * . 

b. The parameter to pass on successful parse is X ' 85 ' , which is an internal 
code changed earlier in the example. 

c. The routine identifier which is X ' 28 ' for MULT. 

d. This is a CALL action, therefore X ' 00 ' . 

ENTER: S DC00:1F40 1585 2800 
RESPONSE: Ok 

3. This new node will be inserted at the beginning of the input parse sequence. 
This requires a node to transfer the parse to the remaining input parse table. 
The input parse table begins at X ' 545E ' , this address was provided by the T 
IBM3 101 command. The node for transferring the parse will look like this: 

a. X'FE' OTHERS 

b. X ' 00 ' No parameter 

c. X ' 5E54 ' the address for continuing the input parse. 

ENTER: S DC00:1F44 FE00 5E54 
RESPONSE: Ok 
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4. The new input parse nodes are ready to be inserted into the parse. Point the 
TDT to the new beginning of the input parse sequence. 

ENTER: SWDC00:1F22 1F40 

RESPONSE: Ok 

Note: Although this allows the cent sign to be keyed in at the terminal, the cent 
sign still is displayed as a backslash. 



Setting Host Disconnect Methods 



A local 3270 terminal is always connected to its control unit by a coaxial cable. An 
ASCII terminal, however, can be remotely attached to the IBM 7171 over switched 
network telephone lines. If such a connection were lost and the host application 
cannot be appropriately notified, then the next user to dial into the same phone line 
would continue with the interrupted session. The IBM 7171 provides two methods 
to signal line drop to different host access methods. 

Note: By default, the IBM 7171 uses the Asynchronous Status Method described 
below with the VM disconnect. If the control unit will be used with a system 
running another operating system, then the proper disconnect sequence MUST be 
set up by the installation. Failure to do so will cause unpredictable results. 

Setting Up the Asynchronous Status Method: An isolated Device End is a signal from 
a 3270 terminal that it has just powered on. This response is enough for VM to put 
the session into a disconnected state. A BTAM application program can use the 
READYQ keyword on the DCB to intercept the Device End, but many existing 
BTAM applications do not use READYQ. TCAM and VTAM both ignore iso- 
lated Device Ends. If this method is chosen, the IBM 7171 will allow any 
status/sense combination to be sent to the host. 

The word at X ' DC00:E ' is the location where the status/sense information is 
stored. To select this option, store the desired sense in the first byte and the 
desired status in the second byte. If this word is zero, then this method is disabled. 

For example, if the host is running VM, then an isolated Device End is sufficient to 
disconnect the session. Therefore, store X ' 00 ' (no sense) at X ' DC00:E * , and 
X ■ 04 ' (Device End status) at X • DC00:F ' . 



Setting Up the Send Predefined Message to Host Method: When this method is used, 
the IBM 7171 will generate an Attention to the host when a line drop occurs. The 
IBM 7171 will respond to the resulting read with the predefined message which is 
pointed to by X ' DC00:000A ' . If X ' 0000 ' is stored at X • DC00:000A ' , then a 
message will not be sent. 

The format of the message is as follows: 

• Length of the message to be sent (word), 

• Message to be sent to the host. 

The message must be in the form of an EBCDIC datastream which could normally 
be built by a Read Modified command, since interpretation is not performed. 

Typically, the message to be sent to the host is a Test Request header followed by 
the word "LOGOFF." The 7171 contains this message in the correct format in 
ROM, and so all that needs to be done is to store the address in X ' DC00:000A * . 
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This address is contained in ROM index 120, so use the Maintenance Facility to 
enter the correct index: 

SW DC00:A 8078 

If this message is not sufficient, then any message that conforms to the above con- 
straints can still be stored in NV-RAM in any of the available storage locations. 
For most applications, the best location to store the message is near the end of 
NV-RAM (do not write to X ■ 1FFE ' -X ' 1FFF ' , these are reserved bytes). It is 
important to be careful when updating the terminal definition tables that the dis- 
connect sequence is not overwritten. 

For example, if the same disconnect message were to be set up in NV-RAM, the 
following would be required: 

1. Two bytes for the message length, 

2. Four bytes for the Test Request header, 

3. Six bytes for the LOGOFF message. 

Here are the steps: 

1 . Enter the Maintenance Facility. 

2. Enter the following commands: 

S DC00:1FF2 0A00 016C 6102 D3D6 C7D6 C6C6 
SW DC00:A 1FF2 

The "S" command stores the two byte message length which is 10 bytes, the Test 
Request Header (SOH % / STX), and the "LOGOFF" message to be sent to the 
host. The "SW" command sets the pointer to this disconnect message. Note that 
the message is in the form of an EBCDIC datastream which could normally be built 
by a Read Modified command. 

The net effect is to emulate the datastream that would be generated if the user 
typed the word LOGOFF on a clear screen and then pressed the Test Request key. 
This will generate a disconnect on ACF VTAM Version 1 Release 3 or Version 2. 
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Chapter 5. IBM 7171 I/O Interface to Terminals 



5.1 Common Carrier Interface 



The IBM 7171 is a controller through which RS-232-C ASCII terminals, printers, 
and similar devices can communicate with a host IBM 43xx or 308x processor. As 
many as 64 such devices can be attached to the IBM 7171, and this section 
describes the interface to which they are attached. 

Each of the IBM 7171 ports is a DTE and expects to be connected to a terminal 
through an asynchronous modem. The modem can be connected to a common car- 
rier's switched network, or to leased transmission lines. It is also possible to attach 
a terminal directly to the interface through a specially wired cable called a "Null 
Modem Cable." 



5.1.1 United States Interface Compliance 



The IBM 7171 conforms to the following standards when installed within the 
United States. 



Functional/Electrical/Mechanical 



Mechanical 



EIA RS-232-C Interface between Data Terminal Equipment and Data Commu- 
nication Equipment Employing Serial Binary Data Interchange 

The EIA RS-232-C standard defines functional, electrical, and 
some of the mechanical characteristics of the interchange circuits 
used between the terminals and the IBM 7171. 



ISO 2110 Data Communication - 25-pin DTE/DCE interface connector 

and pin assignments 

International Standard ISO 2110 defines the 25-pin "D" con- 
nector commonly used by RS-232-C equipment. 
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5.1.2 World Trade Interface Standards Compliance 



Functional/Procedural 



Electrical Interface 



Mechanical Interface 



The IBM 7171 conforms to the following standards when installed outside of the 
United States. 



CCITT V.24 List of Definitions for Interchange Circuits Between Data Ter- 
minal Equipment (DTE) and Data Circuit-Terminating Equip- 
ment (DCE). 



CCITT V.28 Electrical Characteristics for unbalanced double-current inter- 
change circuits. 



ISO 2110 Data Communication - 25-pin DTE/DCE interface connector 

and pin assignments 



5.2 Communication Ports Hardware Interface Description 

This section describes the RS-232-C/V.24 ports of the IBM 7171. 

5.2.1 The IBM 7171 Definition as a DTE 

The IBM 7171 is configured as a DTE. It drives the signals DTR and RTS, and it 
receives the signals DSR, CTS, RLSD, and RI. Each port has a 25 pin male "D" 
connector - the type normally used for RS-232-C interfaces. By using a 
one-to-one cable, a port can be connected directly to a modem or another device 
with an interface like a modem. More sophisticated users will be able to configure 
other cables and connector wiring to allow the attachment of other devices which 
do not attach directly. 

5.2.2 RS-232-C/CCITT V.24 Pins Used by the IBM 7171 

The following figures summarize the Data Transmission Configurations and inter- 
face standards supported. The two interface standards are basically the same 
except for the names of the signals on the pins. 

In the switched network configuration, the cable will connect the ten pins available 
at the IBM 7171 port connector to the respective pins of the modem connector. 
This is a common one-to-one cable which is available from many vendors. 
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In the leased line configuration, if the attached modem drives the Ring Indicator 
signal (pin 22), the common one-to-one cable can be used. If the attached modem 
does not drive the Ring Indicator signal, then at the IBM 7171 end of the cable, pin 
22 must be wired to pin 7 at the connector. It is possible to configure any port for 
a leased line modem, which eliminates the need to condition the Ring Indicator 
signal at all. Section 9.8, "C - Configure IBM 7171 Ports" on page 9-7 describes 
how to configure a port. 



For the directly connected configuration, a specially configured cable is required. 
That cable, which may be unique to a specific terminal, will probably have pins at 
one end of the cable wired to different pins at the other end, and will likely have 
some pins at each end jumpered to other pins at that same end. It is common, for 
instance, to use a cable having female connectors at both ends with pin 2 at one 
end wired to pin 3 at the other end. 

Refer to the IBM 71 71 ASCII Device Attachment Control Unit Description and 
Planning Guide (Appendix B) for specifics regarding recommended cable wiring. 
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Figure 5-1. Data Transmission Configuration Types and RS-232-C Pin Requirements. The direction is referenced to the 
IBM 7171 e.g. Received Data is an input to the IBM 7171. 

The signals marked with an "x" are wired between the IBM 7171 and the attached device while the signals 
marked with an "*" are usually jumpered within the housings on the ends of the cable. 

The signals marked with an "=" should be driven inactive by the DCE, or strapped to signal ground in the 
cable. 
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Figure 5-2. Data Transmission Configurations Types and CCITT-V.24 Pin Requirements. The direction is referenced to 
the IBM 7171 e.g. Received Data is an input to the IBM 7171. 

The signals marked with an "x" are wired between the IBM 7171 and the attached device while the signals 
marked with an "*" are usually jumpered within the housings on the ends of the cable. 

The signals marked with an "=" should be driven inactive by the DCE, or strapped to signal ground in the 
cable. 
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5.2.3 Signals Driven by the IBM 7171 

The IBM 7171 drives the following signals to declare that it is ready to be used. 

DTR Data Terminal Ready (Pin #20) 

RTS Request To Send (Pin #4) 

A modem attached to one of the IBM 7171 ports should not attempt to establish a 
connection until the DTR control lead is driven active. Once a connection has 
been made, the active states of DTR and RTS will maintain that connection. 
During the operational phase, the IBM 7171 will monitor these input signals and 
will respond to their changing states. When the IBM 7171 is to disconnect the 
modem, DTR and RTS are driven inactive for about four (4) seconds. When the 
IBM 7171 port recognizes that the attached modem has disconnected, it will then 
redrive DTR and RTS active awaiting a new connection. 

Since the IBM 7171 expects to be communicating to a terminal through a modem, 
a directly connected terminal will have to respond correctly to DTR and RTS, an 
attachment that is commonly done. 

5.2.4 Interface Leads Monitored by the IBM 7171 

The following four (4) leads are monitored at each of the IBM 7171 ports. 

DSR Data Set Ready (Pin #6) 

CTS Clear To Send (Pin #5) 

RLSD Received Line Signal Detector (Pin #8) 

RI Ring/Calling Indicator (Pin #22) 

These signals driven by the modem reflect the states of the modem's operation and 
are used by the IBM 7171 to establish the connections, send and receive data and 
disconnect the modem. 

The IBM 7171 can use the Ring Indicator to distinguish a switched network config- 
uration from the leased line and locally attached configurations. 



5.3 Transmission Mode Supported 



Devices attached to the IBM 7171 ports must be Full Duplex. They must assert the 
Request to Send (RTS) lead when ready to establish a connection with the IBM 
7171, and this signal must be held in the active state for the duration of the session. 
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5.4 Baud Rates Supported 



The following baud rates are supported by the IBM 7171. 
50 
75 
110 
134.5 
150 

• 300 

• 600 

• 1200 

• 1800 

• 2000 

• 2400 

• 3600 

• 4800 

• 7200 

• 9600 

• 19200 

The highlighted baud rates are supported for "autobaud detection" described 
below. Any port can be assigned any of the above rates by making an entry into 
Non- Volatile RAM (NV-RAM). Section 9.8, "C - Configure IBM 7171 Ports" 
on page 9-7 describes how to configure a port including setting the baud rate. 



5.4.1 Autobaud Detection Option 



The IBM 7171 is able to detect the baud rate of a terminal when the connection is 
established as long as the rate is one of the highlighted rates listed above. If a port 
is configured for autobaud detection, the IBM 7171 will monitor the first character 
transmitted by the attached terminal. The terminal must transmit a carriage return, 
and from that the IBM 7171 can determine the baud rate which will be used for the 
remainder of the session. 
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5.5 Autoanswer Mode 



The IBM 7171 operates in an autoanswer mode. When it is available and online, it 
drives the DTR output control lead active at the RS-232-C interfaces. When DTR 
is held active, a modem with the autoanswer feature will automatically answer 
incoming calls to the IBM 7171. 

At certain times (when the IBM 7171 is powered off for example) DTR is not 
driven active. Switched network modems should not answer incoming calls when 
DTR is inactive. 



5.6 Port Initialization 



5.6.1 Monitoring of Control Leads for Initializing a Port 



When the IBM 7171 is powered on and running, it monitors the input signals of 
each port. 

During the initialization phase of each port, the IBM 7171 drives DTR and RTS 
active. When it is ready to begin a session, the attached device must bring the 
proper input signals active as described in the EIA RS-232-C standard. This 
attached device must be either a modem or another device which appears to be a 
modem. When the signal states satisfy the requirements of both the IBM 7171 and 
the attached device, the initialization phase is complete, and the IBM 7171 will 
enter the operational phase. 



Initialization Control Leads Sequence 



By driving DTR and RTS active, the IBM 7171 notifies the attached device that it 
is available for use. The attached modem must use DTR to enable autoanswer 
mode, while RTS is used to enable the drivers in the modem. 

The IBM 7171 supports three types of configurations: switched network, leased 
lines, and direct connection. During its initial power on sequence, the IBM 7171 
references NV-RAM, to determine the type of configuration for each port. 
NV-RAM contains a table of information for each port, and one entry in that table 
defines the type of attachment. The default entry is "auto-configuration," but that 
can be overridden as described in section 9.8, "C - Configure IBM 7171 Ports" on 
page 9-7. In the auto-configuration mode or switched network (dedicated) mode, 
the IBM 7171 monitors and reacts to the Ring Indicator signal sequencing. The 
Ring Indicator lead (pin 22) must be driven to a valid state. If the attached device 
does not drive the signal to a defined active/inactive level, it must be jumpered to 
Signal Ground (pin 7), or the configuration should be specified as described in 
section 9.8, "C - Configure IBM 7171 Ports" on page 9-7. 
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5.7 Operational Phase 



The operational phase is the normal running state of each of the IBM 7171 ports. 
It is entered when the RS-232-C control lead handshaking of the initialization 
phase has been completed. The operational phase is evident when the terminal 
keystrokes are echoed back to the display, or messages are displayed. It is possible 
for the port to be in the operational phase, but for various reasons the IBM 7171 is 
unable to communicate with the host operating system. The user will normally see 
one of several indications when his port enters the operational phase. 

• On a port for which the baud rate and terminal type have been defined, the 
host operating system logo will appear if the system is available. 

• If the baud rate is defined, but the terminal type is not, the message "ENTER 
TERMINAL TYPE" will appear. 

• If the terminal type is defined, but the baud rate is not, no indication will be 
seen. The user will have to type the CARRIAGE RETURN key, and then the 
host operating system logo will appear if the host connection is up and running. 

• If neither the baud rate nor the terminal type is defined no indication will be 
seen. The user will have to type the CARRIAGE RETURN key, and then the 
message "ENTER TERMINAL TYPE" will appear. 

Once the IBM 7171 enters the operational phase for any port, it will begin trans- 
ferring the characters and commands to and from the attached device. The 
RS-232-C signals are monitored and will affect the data transfer. For example, a 
printer may accept a line of characters at a high rate, but then will not accept any 
more until that line is printed. The printer will drive the CTS signal inactive when 
it cannot accept any more data, and will drive it active when it is ready for more 
characters. The IBM 7171 will react properly to those control signals. 



5.7.1 Control Leads During Operational Phase 



During the operational phase, the control signals are monitored. There are two 
normal conditions which will cause these signals to be driven inactive. The first is 
caused by the attached device wanting to stop the data transfer for a moment. 
That stopping of the data transfer is called "pacing" and is covered in the following 
section. The second is caused by the attached device signalling the end of a 
session. When DSR, CTS or RLSD is driven inactive, the IBM 7171 starts a timer 
for that port. If the timer runs out before that signal becomes active again, the 
IBM 7171 will disconnect that port. More details on disconnection are found in 
the section 5.10, "Disconnection" on page 5-13. 



5.8 Pacing 



Some attached devices, such as printers, may not be able to handle characters as 
fast as they can be received. Some of those devices have the ability to send a char- 
acter back to the transmitting unit asking it to stop momentarily while the receiving 
unit catches up. When it has caught up, the receiving unit can then send another 
character signalling the transmitting unit to continue. This form of stopping and 
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starting the transmitting unit on demand is called "pacing," and such devices can 
be used with the IBM 7171. 

In a similar sense, the IBM 7171 has the ability to send pacing characters to an 
attached device when managing its respective input buffer resources. 



5.8.1 XON/XOFF 



Pacing Enable 



Although the IBM 7171 will receive any pacing characters sent by the attached 
device, it will not respond to them, or send them, unless pacing recognition has 
been enabled. Pacing character recognition is enabled with the "Restore Pacing" 
setup function, and it is disabled with the "Suppress Pacing" set up function. 
These two functions are described in section 3.1.6, "Setup Functions" on 
page 3-3. 



XON & XOFF Characters Received From a Device. 



When pacing is enabled for a port, all characters received by the IBM 7171 on that 
port are compared to the defined XON and XOFF characters for that port. Dif- 
ferent ports may have different characters for XON and XOFF. 

When the attached device sends the XOFF character, and pacing is enabled, the 
IBM 7171 will stop sending characters to that attached device. If a second XOFF 
character is received, it will just be ignored. 

When the attached device sends the XON character, and pacing is enabled, the 
IBM 7171 will resume sending any buffered characters to that attached device. If a 
second XON character is received by the IBM 7171 on that port, it will be ignored, 
and a BEL character will be sent to that attached device. 



XON & XOFF Characters Sent to the Device. 



When pacing is enabled for a port, the IBM 7171 may send the attached device 
Pacing characters. The IBM 7171 will send the device an XOFF character when 
the input buffer accumulates three hundred (300) characters. If the input buffer 
continues to fill, another XOFF will be sent when the count reaches 308, 316,324, 
and 332 characters. The input buffer will overrun at three hundred forty (340) 
characters. 

Note: The buffer count is not necessarily related to block lengths, since internal proc- 
essing of data commences immediately. 

If an XOFF character is sent to the attached device because one of the input buffer 
thresholds has been reached, then an XON character will be sent to that device 
when the input buffer has been processed within forty (40) characters of being 
emptied. 
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5.8.2 Control Signal Pacing 



As mentioned above, the attached device can drive CTS, DSR, or RLSD inactive 
which stops any data transmission. Normally the CTS signal is used as a pacing 
control signal, and will cause the IBM 7171 port to stop transmitting momentarily. 
There are time limits associated with each of these control lines, and exceeding 
those limits will cause the IBM 7171 to disconnect that port. CTS can be inactive 
for as long as ten seconds, but DSR is limited to 100 milliseconds and RLSD is 
limited to 500 milliseconds. The CTS value is fixed, but the DSR and RLSD values 
are default values in the port table in NV-RAM, and are alterable as described in 
section 5.10, "Disconnection" on page 5-13. 



5.9 Attachment Configurations Supported. 



The IBM 7171 supports three types of attachment configurations: 

1. Switched Network 

2. Leased Line 

3. Locally Attached. 

The configuration for each port is stored in NV-RAM and can be modified as 
shown in section 9.8, "C - Configure IBM 7171 Ports" on page 9-7. A fourth 
configuration is called auto-configuration. In that mode the IBM 7171 will attempt 
to determine which of the above three modes to use for that port. 

For the auto-configuration mode to work properly, the Ring Indicator lead (pin 22) 
at the IBM 7171 RS-232-C port must be properly conditioned. It must not be left 
floating. If the modem or terminal does not drive the Ring Indicator to the marking 
condition (except to indicate a ringing state at which time it is driven to the spacing 
condition), then that signal must be jumpered to Signal Ground (pin 7) at the IBM 
7171 end of the cable. Because the receiver input impedance is high, noise can be 
easily coupled into a floating input which can cause the IBM 7171 to disconnect 
that port as described in the paragraph on invalid interface lead sequences on 
page 5-14. 



5.9.1 Switched Network 



General Description of Switched Network Configuration 



The switched network is the basic dial-up telephone network used with normal 
telephone calls. A port attached to the switched network through a modem would 
have a telephone number. A user at a terminal prepares the terminal and then dials 
the telephone number of the modem on the IBM 7171 port. The signals on the 
IBM 7171 port allow the modem to answer the call and signal the IBM 7171 when 
the line is ready. 
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Cabling Requirements 



To attach a modem (DCE) to the IBM 7171 port (DTE), a common one-to-one 
RS-232-C cable with a male connector on the DCE end and a female connector on 
the DTE end is used. That cable can be built from components or can be pur- 
chased from many vendors. A description of the cable is included in Appendix B 
of IBM 71 71 ASCII Device Attachment Control Unit Description and Planning 
Guide. 



General Switched Modem Specifications 



Modems interfacing between the IBM 7171 port and the switched telephone 
network should be configured to automatically answer incoming calls. They should 
also be configured (if possible) to answer incoming calls only when the DTR signal 
is driven active by the IBM 7171 port. When DTR is not active, the IBM 7171 
port is not ready to receive any calls. 

Modems should be configured so the RLSD signal reflects the true state of the tele- 
phone carrier signal. If the remote modem is powered off for any reason, the IBM 
7171 port should be able to detect it and react accordingly. 

The Ring Indicator signal is expected to be driven by the modem even if it is con- 
figured for the autoanswer mode. The IBM 7171 expects that the Ring Indicator 
signal will be driven active and then inactive at least once before the line is 
answered. 

The Data Set Ready signal is expected to be driven inactive for a period of at least 
200 milliseconds between sessions. In the switched network configuration (over- 
ride), or autoconfiguration perceived as switched network environments, the line 
will not be restarted until the DSR drop has occurred. 



5.9.2 Leased Line 



General Description of the Leased Line Configuration 



Cabling Requirements 



A leased line is a direct connection between two modems. The lines are not routed 
through the telephone company switching equipment, but rather bypass the 
switches. A leased line modem sequences its RS-232-C interface signals differently 
from a modem attached to the switched network. The Ring Indicator, for example, 
is never driven active by a modem on a leased line. Those differences are impor- 
tant to the IBM 7171 as it initializes a session and as it disconnects a modem. The 
modems connected to leased lines are frequently very different from those used in 
the switched network. The IBM 7171 uses the differences between switched and 
leased line modems to determine how to sequence the RS-232-C signal lines. 



To attach a modem (DCE) to the IBM 7171 port (DTE), a common one-to-one 
RS-232-C cable with a male connector on the DCE end and a female connector on 
the DTE end. That cable can be built from components or can be purchased from 
many vendors. A description of the cable is included in Appendix B of IBM 71 71 
ASCII Device Attachment Control Unit Description and Planning Guide. 
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Warning: For auto-configuration to work properly, the Ring Indi- 
cator lead (pin 22) must be properly conditioned. If the modem does 
not drive Ring Indicator to the marking condition, then that signal 
must be jumpered to Signal Ground (pin 7) at the IBM 7171 end of 
the RS-232-C cable. 



5.9.3 Locally Attached (Direct Connection) 



General Description of Local Attach Configuration 



Cabling Requirements 



The RS-232-C interface was designed to allow connection between DCE's 
(modems) and DTE's (terminals and computers). The RS-232-C standard allows 
up to 2500pf of capacitance in the signal lines which means that the cable could be 
up to about 50 feet long. Many users have terminals within 50 feet of their 
processors and do not see a need for buying two modems just to go that distance. 
The problem then is that they want to attach a DTE (terminal) to another DTE 
(computer), and that is not included in the RS-232-C standard. It has been deter- 
mined that by wiring the RS-232-C cable between the DTE's in a special manner, 
the cable can successfully emulate a DCE. In that cable, some signals are just 
wrapped back to other pins on their connectors, while other signals are crossed 
from one end of the cable to the other. Such a cable is commonly referred to as a 
"null modem cable." 

Users have also realized that 50 feet is a somewhat arbitrary distance. While they 
are in violation of the RS-232-C standard, they have been able to use cables which 
are much longer than the standard allows and have been able to run successfully. It 
is not uncommon to find cables several hundred feet long, especially when running 
at lower baud rates. The long cables degrade the shape of the data signals which 
will potentially cause more transmission errors. 



The null modem cable will be specific to each computer and terminal pair although 
many are the same. Each cable will have to be assembled by the user since they 
are not available from vendors. 

A formal description of these cables is found in Appendix B of IBM 71 71 ASCII 
Device Attachment Control Unit Description and Planning Guide. 

Warning: For auto-configuration to work reliably, the Ring Indicator 
lead (pin 22) must be jumpered to Signal Ground (pin 7) at the 7171 
end of the cable. 
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5.10 Disconnection 



When the IBM 7171 terminates a session, it disconnects or drops the line. There 
are two classes of disconnection. In the first, the host computer has initiated the 
disconnection. The user may have given the host the command to logoff for 
example. In the second, the IBM 7171 has recognized a problem and has discon- 
nected the line itself. For example one of the RS-232-C signal lines may have gone 
inactive for a period exceeding the timeout limit. The first is called "host initiated" 
and the second is called "unsolicited." While either class is acceptable for discon- 
nection, there are differences in the way in which the IBM 7171 handles them. If 
the disconnection is unsolicited, one cause could be trouble in the telephone 
system. If a new connection is then established, the IBM 7171 must make sure that 
some new user does not dial into the middle of the previous user's session. 



5.10.1 Method of Disconnection 



The IBM 7171 disconnects a port by driving DTR and RTS inactive on that port. 
The modem should respond by driving its lines inactive. Normally these signals are 
held inactive for about four seconds, but in certain situations the disconnection 
sequence may be repeated. 



5.10.2 Types of Disconnection 



Unsolicited 



Loss of DSR beyond limits. 

The IBM 7171 monitors the DSR signal from the modem. If and when DSR is 
driven inactive, a timer starts on that port. If DSR is not yet active when the 
timer runs out, the IBM 7171 will disconnect that port. That timer is set to 20 
milliseconds during the initialization phase and defaults to 100 milliseconds in 
the operational phase. The operator has the ability to change operational 
phase value if desired. Use the Maintenance Facility command: 

sw DCOO:0290 XXXX 

where XXXX is the new delay value expressed in hexadecimal (e.g. for a new 
delay value of 600 milliseconds XXXX would be 0258). 

Some modems drive DSR with a mechanical relay. Since relays give erratic 
signals as they switch, the IBM 7171 will allow 50 milliseconds during initial- 
ization for the bouncing to stop. A typical relay will bounce for a couple of 
milliseconds. 

If the modem is powered off, or if the cable becomes loose, the loss of DSR 
will cause the unsolicited disconnection. 

Loss of RLSD beyond limits. 

The IBM 7171 monitors the RLSD signal from the modem. This signal is 
sometimes called DCD (Data Carrier Detect) and is active when the modem 
attached to the IBM 7171 port is detecting the carrier signal from the other 
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modem. If the carrier is lost, RLSD indicates that the other modem has been 
turned off, the cable is disconnected, or some similar problem. If the IBM 
7171 detects that the modem has driven RLSD inactive, it will start a timer. If 
RLSD is not driven active again before the timer runs out, the IBM 7171 will 
disconnect that port. The IBM 7171 is delivered with the RLSD timer set to 
500 milliseconds for all ports, but the operator can change it if desired. Use 
the Maintenance Facility command: 

sw DCOO:0292 XXXX 

where XXXX is the new delay value expressed in hexadecimal (e.g. for a new 
delay value of 600 milliseconds XXXX would be 0258). 

Loss of CTS beyond limits. 

The IBM 7171 monitors the CTS signal from the modem. During the line 
initialization of some of the higher speed modems, several seconds may elapse 
while the modems condition the transmission line. CTS can also be used by 
the modem (or null modem attached device) to pace the data being sent to it. 
When the IBM 7171 detects that CTS is being driven inactive at a port, it 
starts a ten second timer. If CTS is not driven active again before that timer 
expires, the IBM 7171 will disconnect that port. 

Invalid interface control lead sequences. 

Certain unexpected control signal sequences will also cause the IBM 7171 to 
disconnect a port. If, for example, a port is in the operational phase with data 
flowing back and forth between the IBM 7171 and a terminal, and the Ring 
Indicator should become active indicating a new incoming call is being 
received, the IBM 7171 will recognize an inconsistent state on that port and 
will disconnect it. 

Terminal Powered Off 

If a modem or directly attached terminal is powered off, the RS-232-C signals 
on that device will drift to their inactive states. The IBM 7171 port will detect 
them and will start the timers. When the first of the timers runs out, the IBM 
7171 will disconnect that port. 

Abort Timer. (Switched Network or Autoconfigure) 

The line will be disconnected if the RLSD signal is not activated within thirty 
(30) seconds of answering an incoming call in the Switched Network (over- 
ride) or Autoconfigure mode. The Abort timer is started whenever the line is 
configured switched network, or is percieved as switched network when in 
Autoconfigure mode. 

There are two (2) ways of starting the timer, depending on the configuration 

tnnHp Hp.finp.H* 



| mode defined: 

| — Switched Network (override) configuration. 

| DSR activated by attached device. 
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I — Autoconfiguration (default) 

I Ring Indicator cycled on then off during initialization handshaking. (One 

I complete ring cycle.) 

Warning: When a directly attached device is connected to the 
IBM 7171 port with a null modem cable, it is possible to 
assemble that cable so that the IBM 7171 port can not detect 
that the terminal power has been turned off. That type of 
cable is not recommended, and it could lead to problems main- 
taining user security on the host system. 



Host Initiated 



The host can be commanded to disconnect one of the IBM 7171 ports. This would 
be used as the normal end to an operating session. Section 3.1.6, "Setup 
Functions" on page 3-3 describes the command "Keyboard initiated line drop" 



5.11 Communications Error Handling 



Communication systems are prone to transmission errors, and there are certain 
types of checks built into the transmission scheme. 

The errors that are detected by the IBM 7171 are: 

Parity Error Data character received from attached device has wrong 

parity. 

Framing Error Start and stop bits are not correctly matched. (Possible false 

start) 

Break Interrupt The received data has gone to a space (zero) level for more 

than one character time. (Could be Break Key was 
depressed.) 

Overrun Error The received data has overrun the previously received data 

character before it could be processed. 

These errors occur in the communication from the terminal to the IBM 7171. 
When the IBM 7171 detects one of the above errors, it notifies the user by locking 
the keyboard. As the user tries to enter more characters or commands, the IBM 
7171 will echo back the BEL character instead of the typed character. The user 
can acknowledge and clear this error state by entering the "reset key sequence" 
described in section 3.1.6, "Setup Functions" on page 3-3. 
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Chapter 6. IBM 7171 I/O Interface to the Host System 



It is assumed that the reader is familiar with 3270 style Channel Command Words 
(CCW's) and data streams. They are defined in other IBM documentation. 1 



6.1 High Level Examples 



Data movement between the host and its control units has its direction references 
in relation to the host. This means that Outbound Data is from host to a control 
unit. Inbound Data is coming to the host from a control unit. 



HOST 



IBM 7171 



TERMINAL 



INTERRUPT <«- 



CCW CHAIN: FIRST 
IS SELECT RM 



-► SELECT RM 



CHANNEL END STATUS <+■ 



DEVICE END STATUS <«- 



APPLY READ MODIFIED 
LOGIC TO TERMINAL 
IMAGE AND BUILD 
OUTPUT BUFFER 



CHAINED READ 
MODIFIED CCW 



■> RD MOD 



DATA <«- 



CHANNEL END + <- 
DEVICE END STATUS 

(The terminal keyboard" locks up until a WRITE or E/W command with the) 
(keyboard reset bit on is sent to the terminal. ) 



ENTER KEY 



Figure 6-1. Channel Inbound Data 



Refer to IBM 3270 Information Display System: 3274 Control Unit Description and 
Programming Guide. 
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Inbound data is signaled by an action from the terminal. In the example, in 
Figure 6-1, an ENTER key is hit. The IBM 7171 creates an attention interrupt for 
the host. The host operating system must issue some type of Read command to 
determine what the terminal wants. In this example a CCW chain of Select RM 
and Read Modified is issued. Select RM is used to inform the IBM 7171 that a 
Read Modified command will follow, and that to minimize channel busy the control 
unit should be waiting with the data stream. This is what the example shows, note 
that when the Select RM is received initial status of Channel End is issued and the 
channel is freed up for the time it takes the IBM 7171 to get the data. When the 
data is waiting in the buffer ending status of Device End is issued, informing the 
host that it may issue the following Read Modified CCW. The Read Modified 
command moves the data inbound immediately then supplies ending status of 
Channel End plus Device End. 



HOST 



IBM 7171 



TERMINAL 



CCW: ERASE/WRITE 



DATA STREAM 



CHANNEL END STATUS <«- 



DEVICE END STATUS «- 



| (verify data stream) 



-► ERASE FULL SCREEN 

I 

-► SCREEN DATA 



Figure 6-2. Channel Outbound Data 



Outbound data is initiated by the host. In this example an Erase/Write CCW 
command is being executed. The Erase/ Write command is sent to the IBM 7171, 
followed by the data to write on the screen. When all data is transferred to the 
IBM 7171, it responds with Channel End. Data stream verification and internal 
screen image updating takes place followed by Device End response back to the 
host. The IBM 7171 now sends the new screen image to the terminal. 



6.2 Data Streams 



The control unit provides information to, and accepts information from, the 
channel at an instantaneous byte rate established by the channel or control unit, 
whichever is the slower. 

Write command operations direct movement of data to the terminal systems via the 
control unit. Read command operations receive their data from the screen image 
that exists in the control unit. 
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6.2.1 Interface Codes 



Data, commands, and orders transmitted between the control unit and the host 
system are in the form of interface codes. Two different codes are used in the 
United States: Extended Binary Coded Decimal Interchange Code (EBCDIC) and 
American National Standard Code for Information Interchange (ASCII). The 
EBCDIC codes are also used in World Trade countries (ASCII is available only in 
the U.S.); refer to IBM 3270 Information Display System Character Set Reference, 
GA27-2837, for details. The IBM 7171 only supports the EBCDIC codes from 
the host. 



6.2.2 Data Stream 



The 3270 data stream consists of application data, commands, and orders which 
are transmitted between the control unit and the host system. 

Data transfer commands are issued to initiate such operations as the total or partial 
writing, reading, and erasing of data in a selected terminal character buffer. 
Control commands initiate control unit operations not involved with data transfer 
(except for status information). Orders can be included in write data streams either 
alone or intermixed with display data. 

Buffer control orders are interpreted and executed as they are received by the 
control unit, and are used to position, define, modify, assign attributes on a field 
and character basis, and format data being written to a display character buffer; to 
\ erase selected unprotected data in the buffer; and to reposition the cursor. 



3270 Data Stream Function 



The 3270 outbound data stream consists of a Write Control Character (WCC), 
and if appropriate, orders, character data, and the parameters needed by a control 
command. Inbound data streams consist of orders and character data or requested 
sense and control information. 

The command defines the operation to be performed. 

Commands: The operations which may be specified include: 

Write to the character buffer. 

Erase and then Write to the character buffer. 

Read the entire character buffer. 

Read only the Modified data from the character buffer (some exceptions). 

Erase All the Unprotected data from the character buffer. 

Select a terminal and initiate terminal character buffer to control unit buffer 

transfer of all data, modified data only, or data from position in preparation for 

a Read Buffer, Read Modified or a Write operation. 

Perform No functional Operation, retrieve pending status. 

Sense further definition of the Unit Check condition. 

Sense the Control Unit Identification. 
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Command codes are shown below. 



Command 


EBCDIC 


Erase All Unprotected 


OF 


Erase/Write 


05 


Erase/Write Alternate 


0D 


No Operation 


03 


Read Buffer 


02 


Read Modified 


06 


Select RM 


OB 


Select RB 


IB 


Select RMP 


2B 


Select RBP 


3B 


Select WRT 


4B 


Sense 


04 


Sense ID 


E4 


Write 


01 


Test IO Instruction 2 


00 



Figure 6-3. IBM 7171 CCW Command Codes 



6.2.3 Write Commands 



Write Command 



Three write type commands, Write, Erase/Write, and Erase/Write Alternate are 
used to load, format, and selectively erase device buffer data. These commands 
can also initiate certain device operations such as resetting the keyboard and 
sounding the audible alarm. Write and Erase/Write operations are identical except 
that Erase/Write causes complete erasure of the device buffer before the write 
operation is started. Thus, Erase/Write is used to load the buffer with completely 
new data, whereas Write can be used to modify existing buffer data. 

Erase/Write Alternate is used by some devices to select an alternate size character 
buffer. After this selection is done, it functions as an Erase/Write command. 



The data stream received by the IBM 7171 for a Write type command operation 
consists of a Write Control Character (WCC), followed by orders and/ or data. 

The minimum data stream for a Write type command is a one byte WCC. This is 
ensured because the byte count field of the write channel command word (CCW) 
must be set to a minimum of one or else the command code is not sent. 



2 Test IO Instruction appears to the control unit as a x ' 00 ' command code, but x ' 00 ' 
may not be coded in a CCW. 
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RESET 
BIT 


PRIN 
FOR 


TOUT 
MAT 


START 
PRINT 


SOUND 
ALARM 


KYBD 
RESTORE 


RESET 
MDT 



BITS 1 2 

Figure 6-4. WCC Byte Format 



Bit 


Explanation 


0,1 


Used to make the WCC an EBCDIC/ASCII translatable char- 
acter. 3 


2,3 


Define the printout format, as follows: 

=00 - The CR, NL, FF, and EM orders in the data stream 
determine print line length. Provides a 132 column 
print line when orders are not present. 

=01 - Specifies 40 column print line. 

= 10 - Specifies 64 column print line. 

= 11- Specifies 80 column print line. 


4 


Start Print bit. When set to 1, initiates a printout operation at 
completion of the write operation. 


5 


The Sound Alarm bit. When set to 1, sounds the audible alarm 
at the selected device at the end of the operation if the device 
has an audible alarm. 


6 


Keyboard Restore bit. When set to 1, restores operation of the 
keyboard and resets the AID byte at the termination of the I/O 
command. 


7 


Reset MDT bits. When set to 1 all Modified Data Tag (MDT) 
bits in the selected device buffer are reset before any data is 
written or orders are executed. 



Figure 6-5. Write Control Character (WCC) 

This figure describes the function of each WCC bit. When the WCC specifies an 
operation that does not apply to the selected device (for example, if the Sound 
Alarm bit is set and the selected device does not have an Audible Alarm), the spec- 
ified operation is ignored. When the WCC byte is followed by order or display 
data bytes, only the Reset MDT Bits function, if specified, is performed before the 
write operation; any other WCC function is deferred until all data is written and all 
orders are performed. 

Orders and buffer data follow the WCC byte. Buffer data can be written into any 
specified location of the buffer without erasing or modifying data in the other 
buffer locations. Data characters are stored in successive buffer locations until an 
order is encountered in the data stream which alters the buffer address, or until all 



3 Refer to IBM 32 70 Information Display System: Data Stream Programmer's Reference. 
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the data has been entered. During the write operation, the buffer address is 
advanced one location as each character is stored. 

The buffer location where data entry starts depends upon the following consider- 
ations: 

1. The starting location may be specified by an SB A order that follows the WCC. 
(This order is described later in this chapter under "Orders.") 

2. The starting location will be the buffer address containing the cursor if the 
Write command is not chained or is not preceded in the chain by a Read or 
Write. 

3. The starting location will be the current buffer address if the Write command is 
chained to a preceding Write or Read. 

The formatting and placement of write data and the modification of existing buffer 
data are described under "Orders." 

Programming Notes: 

1. If the commands are being chained, the Write or Erase /Write command with the 
Start Print WCC bit set must be the last command in the chain. If not, the Write 
or Erase /Write command that specifies Start Print will be aborted. 

2. The Printout Format bits are honored only if the Start Print bit is set in the same 
WCC. 

Programming Restriction: A Write command should not be chained from an Erase All 
Unprotected command. If it is, the operation is undefined. 4 



Erase/Write Command 



| Execution of the Erase/ Write command performs two operations: an erase opera- 

| tion and a write operation. The erase operation clears the entire device buffer to 

| nulls, positions the cursor to character location 0, and resets the buffer address to 

I 0. 

| Erase/Write then performs the write and WCC operations in the same manner as a 

| Write command. 



4 Refer to IBM 3270 Information Display System: 3274 Control Unit Description and 
Programming Guide. 
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Erase/Write Alternate Command 



The Erase/Write Alternate command also operates as an Erase/Write command. 
Once the display is placed in alternate mode, operation continues in alternate mode 
until the operator presses the CLEAR key or until an Erase/Write command is 
received. The Erase/Write Alternate command switches the following devices (at 
the host sysgen level) to the alternate size indicated below. 



3278 

Model 

Number 


Default 

Character 

Capacity 


Alternate 

Character 

Capacity 


2 
3 
4 
5 


1920 - 24x80 
1920 - 24x80 
1920 - 24x80 
1920 - 24x80 


1920 - 24x80 
2560 - 32x80 
3440 - 43x80 
3564 - 27x132 



Figure 6-6. 3270 Default and Alternate Screen Sizes 
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6.2.4 Orders and Attributes 



Orders 



Orders can be included in Write, Erase/Write, or Erase/Write Alternate command 
data streams, either alone or intermixed with display or print data. Two types of 
orders are available: printout format orders and buffer control orders. Printout 
format orders are initially stored in the buffer as data and are subsequently exe- 
cuted only during a print operation. 

The following paragraphs describe buffer control orders, which are executed as 
they are received in the write data stream by the IBM 7171; these orders are not 
stored in the buffer. Seven buffer control orders (see following figure) are pro- 
vided to position, define, and format data being written into the buffer, to erase 
selected unprotected data in the buffer, and to reposition the cursor. 

Start Field (SF) Order: This order implies that the next byte in the write data 
stream is an attribute character. The IBM 7171 then stores this attribute character 
at the current buffer address. 

Note: The byte immediately following the SF order in the data stream is always 
stored as an attribute character, even when the byte is intended as an order or an 
alphameric data character. 

During execution of a Read Buffer command, the IBM 7171 automatically inserts 
SF order codes in the read data stream immediately before each attribute character. 
This permits identification of the attribute characters by the program and also 
permits correct storage of attribute characters in the buffer if the read data is used 
for subsequent write operations. 

Graphic Escape (GE) Order: This order implies that the next byte in the write 
datastream is a 3278 APL character. The IBM 7171 stores this APL character at 
the current buffer address. 

Note: The byte immediately following the GE order in the data stream is always 
stored as a 3278 APL character (assuming the IBM 7171 is in 3278 mode), even 
when the byte is intended as an order or an alphameric data character. 

Set Buffer Address (SBA) Order: This three byte order specifies a new buffer 
address from which write operations are to start or continue. Set Buffer Address 
orders can be used to write data into various areas of the buffer. An SBA order 
can also precede another order in the data stream to specify the starting address for 
a PT, RA, or EUA order; to specify the address at which an attribute byte is to be 
stored by an SF, or to specify the address at which the cursor is to be repositioned 
by an IC order. 
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ORDER 


BYTE 1 

EBCDIC 

(HEX) 


BYTE 2 


BYTE 3 


BYTE 4 


START FIELD (SF) 


1D 


attribute 
character 






GRAPHIC ESCAPE 

(GE) 


08 


character 
to convert 






SET BUFFER ADDRESS 
(SBA) 


11 


1st address 
byte 


2nd address 
byte 




INSERT CURSOR (IC) 


13 








PROGRAM TAB (PT) 


05 








REPEAT TO ADDRESS 
(RA) 


3C 


1st address 
byte 


2nd address 
byte 


character 

to be 
repeated 


ERASE UNPROTECTED 
TO ADDRESS (EUA) 


12 


1st address 
byte 


2nd address 
byte 





Figure 6-7. Buffer Control Orders and Order Codes 

If the SBA order specifies an invalid address, the write operation is terminated at 
this point. 

When a Read Modified command is executed and an attribute character (initially 
sent to the device by writing an SF order) is detected with the MDT bit set, the 
IBM 7171 inserts, in place of the attribute, an SBA code followed by the two byte 
buffer address of the first character in the modified field (attribute address +1). 
This permits identification by the control unit of fields that are modified. 

Insert Cursor (IC) Order: This order repositions the cursor to the location specified 
by the current buffer address. Execution of this order does not change the current 
buffer address. For example, if IC is issued when the current buffer address is 160 
and the cursor is at location 80, the cursor is moved from location 80 and inserted 
at location 160. The current buffer address at the end of this operation would 
remain 160. 

Program Tab (PT) Order: The PT order advances the current buffer address to the 
address of the first character position of the next unprotected field. If the PT is 
issued when the current buffer address is the location of an attribute byte of an 
unprotected field, the buffer address advances to the next location of that field 
(one location). In addition, if the PT order in the write data stream does not follow 
a control command, order, or order sequence such as a WCC, IC, or RA, nulls are 
inserted in the buffer from the current buffer address to the end of the field, 
regardless of the value of bit 2 (protected/unprotected) of the attribute character 
for the field. When the PT order follows a control command, order, or order 
sequence, the buffer content is not modified for that field. 

The PT order stops its search at the last location in the buffer. If an attribute char- 
acter for an unprotected field is not found by this point, the buffer address is set to 
location 0. (If the PT order finds an attribute character for an unprotected field in 
the last buffer location, the buffer address is also set to zero.) 
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To continue the search for an unprotected field, a second PT order must be issued 
immediately following the first one. Since the current buffer address was reset to 
by the first PT order, the second PT order begins its search at buffer location 0. If 
the previous PT order was still inserting nulls in each character location when it 
terminated at the last buffer location, the new PT order will continue to insert nulls 
from buffer location to the end of the current field. 

Repeat to Address (RA) Order: The RA order stores a specified alphameric or null 
character in all buffer locations, starting at the current buffer address and ending at 
(but not including) the specified stop address. This stop address and the character 
to be repeated are identified by the bytes immediately following the RA order in 
the write data stream, as follows: 



BYTE 





1 

2 
3 


RA Order 

Stop Address (byte 1) 
Stop Address (byte 2) 
Character to be repeated 


OR 





1 

2 
3 
4 


RA Order 

Stop Address (byte 1) 
Stop Address (byte 2) 
Graphic Escape 
Character to be repeated 



Figure 6-8. Repeat to Address (RA) Order Formats 

The third character (fourth if the third is Graphic Escape) following the RA order 
is always interpreted as the character that will be repeated. If an invalid stop 
address is specified, the write operation is terminated at this point without storing 
the character, and error status is generated. 

When the stop address is lower than the current buffer address, the RA operation 
wraps from the last position in the buffer to the first. When the stop address equals 
the current address, the specified character is stored in all buffer locations. 

Attribute characters will be overwritten by the RA order if they occur before the 
RA order stop address. 

Erase Unprotected to Address (EVA) Order: The EUA order inserts nulls in all 
unprotected buffer character locations, starting at the current buffer address and 
ending at, but not including, the specified stop address. This stop address is speci- 
fied by two address bytes which immediately follow the EUA order in the write 
data stream. If an invalid address is specified, the write operation is terminated at 
this point and error status is generated. 

When the stop address is lower than the current buffer address, the EUA operation 
wraps from the last position the buffer to the first. When the stop address equals 
the current address, all unprotected character locations in the buffer are erased. 

Attribute characters are not affected by the EUA order. 
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6.2.5 Read Commands 



Read Buffer Command 



The Read type commands executed by the IBM 7171 are Read Buffer and Read 
Modified. Read Buffer causes the entire buffer contents of the addressed terminal 
to be read into main storage. The operation initiated by Read Modified is deter- 
mined by display station operator actions. The information read during execution 
of Read Modified could consist of fields of data modified by keyboard operations, 
buffer addresses, data of CURSOR SELECT fields, or the code of a Program 
Function or Program Access key. 

An operator action that requires program interaction causes an attention inter- 
ruption; the program would respond to this attention interruption with a read 
command. 

Programming Note: Unsolicited read commands are not recommended because the 
information read by these commands may be incomplete. 5 



Execution of the Read Buffer command causes all data in the addressed device 
buffer, from the buffer location at which reading starts through the last buffer 
location, to be transferred to main storage. This command is provided primarily for 
diagnostic purposes. The transfer of data begins from the current buffer address if 
the Read Buffer command is chained. Regardless of where the transfer of data 
begins, data transfer from the buffer will terminate when the last character location 
in the buffer has been transferred, or before the last character location has been 
transferred when the channel byte count reaches (in this case, the buffer address 
after termination is undefined). 

The transferred data stream begins with a three character read heading consisting 
of the AID character followed by a two character cursor address. The contents of 
all buffer locations are transferred, including nulls. Start Field (SF) orders are 
inserted to identify the beginning of each field. The possible Attention Identifica- 
tion (AID) byte configurations are shown in the following figure. An AID byte 
other than X ' 60 ' is set when the operator at the selected display station has per- 
formed an operation that requires program intervention. These operations are 
either pressing a Program Function or Program Access key, or detecting an atten- 
tion field with the CURSOR SELECT key. 



Refer to IBM 3270 Information Display System: 3274 Control Unit Description and 
Programming Guide. 
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Figure 6-9. Attention ID (AID) Configurations 
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Read Modified Command 



Read Modified initiates one of three operations, as determined by operator actions 
at the display station: 



1. a Read Modified, 

2. a Short Read, or 

3. a Test or System Request Read. 

Figure 6-9 on page 6-12 lists the operator actions and the resulting Read Modi- 
fied command operation initiated by each action. 

A major feature of Read Modified command operations is null suppression. The 
device buffer is cleared to all nulls when the operator turns power on or presses the 
CLEAR key, or when the erase portion of an Erase/Write command is executed at 
the selected device. Also, selected portions of a buffer can be cleared to nulls by 
the Erase All Unprotected command and certain orders. During Read Modified 
command operations, null codes are not sent. 

Read Modified Operation: During a Read Modified command, if an AID other than 
the CURSOR SELECT key, a PA key, or the CLEAR key is generated, all fields 
that have been modified by a keyboard or the CURSOR SELECT key are trans- 
ferred to the program. All nulls are suppressed during data transfer and thus are 
not included in the read data stream. As a field is modified by the operator, the 
modified data tag (MDT) bit is set in the attribute byte for that field. Then, when 
a read modified operation is performed, successive attribute bytes are examined for 
) a set MDT bit. When the bit is found, the data in the associated field is read (with 

nulls suppressed) before the next attribute byte is examined. 

The first three bytes of the read data stream are always the AID code and the two 
byte cursor address; these bytes are called the "read heading." 

Following the read heading is the alphameric data of each modified field. The data 
for each field is preceded in the data stream by a Set Buffer Address (SBA) order 
code followed by the two byte buffer address of the first character position in that 
field (the attribute address +1). Thus, the read data stream when data has been 
modified is as follows: 
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BYTE 

1 
2 
3 
k 
5 
6 
7 



AID 



CURSOR 
ADDRESS 



SBA 



ATTRIBUTE 
ADDRESS + 1 



ALPHAMERIC 
DATA 



SBA 



ATTRIBUTE 
ADDRESS + 1 



ALPHAMERIC 
DATA 



READ 
HEADING 



FIRST 

MODIFIED 

FIELD 

(NULLS SUPPRESSED) 



SECOND 

MODIFIED 

FIELD 

(NULLS SUPPRESSED) 



Figure 6-10. Read Modified data stream 

If a space AID is generated, fields are not transferred to main storage during the 
read modified operation. Instead, when a set MDT bit is found (indicating 
selector-light pen and/or keyboard activity), only the Read Heading, the SBA 
order code, and the attribute address + 1 are transferred. 

Note that if fields are modified by the keyboard but completion of the modification 
is signaled by CURSOR SELECT operation on other than ampersand character 
designator fields, a resulting read modified operation will read only the address of 
the modified fields, not the modified data. 

The buffer location at which the search begins for attribute bytes that define modi- 
fied fields is a function of command chaining. This location is: 

1. Buffer address if the Read Modified command is unchained or is not pre- 
ceded in the chain by a Write or Read. 

2. The current buffer address if the Read Modified command is chained to a pre- 
ceding Write or Read. 

3. For screens without field definitions, buffer address 0. 

The search for modified field attribute bytes ends when the last buffer location is 
checked. 

The transfer of read data is terminated as follows: 

1. If the last modified field is wrapped from the last buffer location (1919) to the 
first location, the operation is terminated after all data in the field is transferred 
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(nulls are suppressed). The buffer address at the end of the operation is the 
address of the next attribute byte in the buffer. For example, if a modified 
field extends from address 1900 (the attribute byte) to address 79 (wrapped 
field), the data from address 1901 through 79 is transferred (nulls are sup- 
pressed); in this case, the read operation is terminated with the buffer address 
set to 80 (the attribute byte of the next field). 

2. If the buffer does not contain a wrapped modified field, and if the channel byte 
count has not reached zero, the modified data stream is terminated when the 
last modified field is transferred; at the end of the operation, the buffer address 
is set to 0. 

3. If the channel byte count reaches zero before all modified data is transferred, 
read operations are terminated and the remaining modified data is not trans- 
ferred. The buffer address after termination is undefined. 

If the buffer is formatted (contains fields) but none of the fields have been modi- 
fied, the read data stream consists of the three byte read heading only. 

If the buffer is unformatted (contains no fields), the read data stream consists of 
the three byte read heading followed by all alphameric data in the buffer (nulls are 
suppressed), even when part or all of the data has not been modified. Since an 
unformatted buffer contains no attribute bytes, no SBA codes with associated 
addresses or address characters are included in the data stream, and the modifica- 
tion of data cannot be determined. Data transfer starts at address 0, regardless of 
command chaining, and continues to the end of the buffer. At the end of the oper- 
ation, the buffer address is set to 0. This read operation can also be terminated by 
the channel byte count reaching zero before all data is read; in this case, the buffer 
address after termination is undefined. 

Short Read: The Read Modified command causes a short read operation if the 
CLEAR, or a PA key has been pressed at the selected device. During the Short 
Read operation, only an AID byte is transferred to main storage. This AID byte 
identifies the key that was pressed. 

Test Request Read: The Read Modified command causes a Test Request Read 
operation if the test request key sequence has been pressed at the selected device. 
The Test Request Read data stream sent to main storage is as follows: 



BYTE 

1 
2 
3 
4 



SOH 



STX 



INPUT DATA 



Figure 6-11. Test Request data stream (first 4 bytes) 

The remainder of the data stream is the same as described previously for Read 
Modified operations, excluding the three byte read heading (AID and cursor 
address). If the buffer is unformatted, all alphameric data in the buffer is included 
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Control Commands 



in the data stream (nulls are suppressed), starting at address 0. If the buffer is for- 
matted, each attribute byte is examined for a set MDT bit. Each time a set MDT 
bit is found, the alphameric data in the field associated with that bit is sent to main 
storage (nulls are suppressed); if no MDT bits are set, the read data stream consists 
of the Test Request Read heading only. The buffer location at which the search 
for MDT bits begins and the transfer of data ends is the same as described for 
Read Modified operations. 

Test Request Read function usage is determined by the access method. Normally, 
the operator would 

1. clear the display, 

2. enter Test Request data in a predefined format, and then 

3. press the Test Request key sequence. 



Control commands initiate certain control unit and/or device operations not 
involved with the transfer of data (other than status). Three control type com- 
mands are executed by the IBM 7171; Select, Erase All Unprotected, and No 
Operation. The Select commands are all 'Prepare to Send' commands. 

Select Read Modified (RM) Command: Select RM is an immediate command. The 
IBM 7171 executes a Select RM command by preparing for a Read Modified oper- 
ation; that is, the device buffer is searched for any modified fields and the input 
data stream is built. This could result in an AID only (Short Read), Test Request 
Read, or a Read Modified data stream. If the command chained to the Select RM 
command is a Write command, the input data is not used. The write data stream is 
received and processed by the IBM 7171. If the Write command is a WCC, SB A 
xx only, and then chained to a Read Buffer or a Read Modified command, the 
input data stream that had been prepared is not used and the appropriate data 
stream is prepared upon receipt of the Read Buffer or Read Modified command. If 
the command following the Select RM is Read Buffer, the input data is not used, a 
Read Buffer operation is performed, and the data is sent to the host. 

The Select RM sets the current buffer address in a manner equivalent to a Read 
Modified command. 

The Select RM command is used to separate the control unit data preparation from 
the channel operation thereby decreasing channel use. 

Note: The successful use of the "Prepare to Send" Select commands on the IBM 
7171 requires that appropriate code be included in the access methods of the host 
operating system. Host operating system sysgen manuals indicate the macros that 
are a prerequisite. 

Select Read Buff er (RB) Command: Select RB is an immediate command. The 
IBM 7171 executes a Select RB command by preparing for a Read Buffer opera- 
tion; that is, a Read Buffer data stream is built. When the data stream is com- 
pleted, Device End is sent to the host. If the command chained to the select RB 
command is not a Read Buffer, the command will not be accepted, and Channel 
End, Device End, Unit Check, Operation Check will be sent to the host. 
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Select Read Modified from Position (RMP) Command: Select RMP is an immediate 
command. A Select RMP command is executed by recording the Read Modified 
condition and returning Device End. 

The commands following the Select RMP command should be a chained Write 
command followed by a chained Read Modified command. The Write Command 
contains only four bytes (WCC, SBA xx) to set the buffer address. If the sequence 
is other than as described, the command will not be accepted, and Channel End, 
Device End, Unit Check, Operation Check will be sent to the host. 

Upon receipt of the Write command, the IBM 7171 will perform the Read Modi- 
fied from Position preparation, and return Device End to the host when the data 
stream is completed. The Read Modified command is then executed. 

Select Read Buff er from Position (RBP) Command: Select RBP is an immediate 
command. A Select RBP command is executed by recording the Read Buffer con- 
dition and returning Device End. 

The commands following the Select RBP command should be a chained Write 
command followed by a chained Read Buffer command. The Write command con- 
tains only four bytes (WCC, SBA xx) to set the buffer address. If the sequence is 
other than as described, the command will not be accepted, and Channel End, 
Device End, Unit Check, Operation Check will be sent to the host. 

Upon receipt of the Write command, the IBM 7171 will perform the Read Buffer 
from Position preparation, and return Device End to the host when the data stream 
is completed. The Read Buffer command is then executed. 

Select Write Command: Select WRT is an immediate command. A Select WRT 
command is executed by returning Device End to the host. If the chained 
command following the Select WRT is not a Write command, then Channel End, 
Device End, Unit Check, Operation Check will be sent to the host. 

Erase All Unprotected Command: This command performs five functions at the 
addressed device: 

1 . Clears all unprotected buffer character locations to nulls. 

2. Resets to the MDT bit for each unprotected field. 

3. Always unlocks the keyboard. 

4. Resets the AID byte. 

5. Repositions the cursor to the first character location in the first unprotected 
field of the buffer. If no unprotected fields exist, the cursor is positioned to 
buffer location 0. 

Erase All Unprotected is an immediate type command. Upon acceptance of this 
command, the IBM 7171 becomes Busy and sends Channel End initial status to the 
channel. Upon successful completion of this command, the control unit sends 
Device End status asynchronously to the channel and then becomes Not Busy. 
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Programming Restriction: Erase All Unprotected should not be chained to a Write, 
Erase /Write, Erase /Write Alternate, or another Erase All Unprotected command. If 
it is, the resulting operation is not defined. 6 

No Operation Command: The No Operation command performs no functional 
operation, but may be used to retrieve pending status. No Operation is an imme- 
diate command; therefore, Channel End and Device End normally will be pre- 
sented as initial status unless pending status or a busy condition exists. 

Sense Command: The Sense command should be issued in response to Unit Check 
status for further definition of the Unit Check condition. The IBM7171 responds 
to a Sense command by sending 1 byte of sense data to the channel and resets the 
sense register when the Device End (DE) for the command is accepted by the 
channel. 

All other commands to the same address, except a No Operation or a Test I/O 
"command" (command code of X ' 00 ' ), reset the sense register immediately when 
the command is issued. Sense commands issued to an address other than the one 
for which sense data is pending are responded to with a Busy and Status Modifier 
(B, SM) initial status indication, and the sense register is not reset. Sense should be 
issued following receipt of Unit Check status to ensure that valid sense information 
is retrieved. 



Refer to IBM 3270 Information Display System: 3274 Control Unit Description and 
Programming Guide. 
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CR 


IR 


BOC 




DC 


US 





oc 



BITS 



Bit 


Name 


Significance 





Command Reject (CR) 


Set if the IBM 7171 has received an 
invalid command. 


1 


Intervention Required 
(IR) 


Set if a command, other than Sense, 
was addressed to a device that is una- 
vailable or is in the "not ready" con- 
dition. 


2 


Bus Out Check (BOC) 


Set if the IBM 7171 has detected bad 
parity on any command or data type 
received from the channel. 


4 


Data Check (DC) 


Set if the CC board sends a command 
to the CPU board, but the addressed 
device is no longer attached. 


5 


Unit Specify (US) 


Set if the sense bits resulted from 
polling the RS-232-C interface. 


7 


Operation Check (OC) 


Set when the IBM 7171 has received 
a valid command or order that it 
cannot execute as follows: 

1. SB A, RA, or EUA order specifies 
an invalid buffer address. 

2. Write data stream ends before all 
required bytes of SBA, RA, EUA, 
or SF order sequences are 
received. 

3 . The IBM 7171 received a 
command chained to Select RB, 
Select RBP, Select RMP or Select 
WRT command other than was 
expected; or the byte count of a 
Write command after RBP or 
RMP was not equal to 4. 



Figure 6-12. Sense Bit Description 



Sense ID Command: The Sense ID command requests data transfer to the host. 
Four bytes of data are sent as follows: 

I FF I 32 I 74 | 1D| 
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Sense ID is honored when the IBM 7171 is in one of the following states: 



Power on 

IML completed 

Online 

Not busy 

No outstanding status to be presented. 



6.2.6 Miscellaneous Operations 



Test Request Function 



Display Fields 



6.2.7 Attributes 



The Test Request message sent to the host (SOH%/STX) is invoked from the 
keyboard. 



A formatted display contains display fields defined by the program. These fields 
consist of blocks of character positions bounded by control characters. The control 
character at the start of a field is set by the program to determine the character- 
istics of the field; this character contains the field attributes. Fields containing 
character positions on more than one row wrap from the last character position on 
one row to the first character position on the next row. A field may wrap the 
screen; if the first character position on the screen does not contain a control char- 
acter, the last field on the screen wraps from the last character position to the first. 
(Some field oriented operations are terminated early if the field wraps the screen; 
this effect is noted in the descriptions of the specific operations.) 

Display fields simplify operations both for the operator and for the programmer. 
Headings can be displayed to prompt the operator as to the data that should be 
entered, and the program can identify fields that contain entered data without 
reading the entire display buffer. When data is being entered into a formatted 
display, the presence of a control character acts as a tab stop; pressing the tab key 
advances the cursor from its current position to the first character position in the 
next unprotected field. (An unprotected field is one that accepts data input from 
the keyboard.) 

To define the start of a field, the program may issue a Write command transferring 
a Set Buffer Address (SBA) order and a Start Field (SF) order to the display; the 
specified buffer address is selected, and the control character specified by the SF 
order is loaded into the addressed location. Only the start of a field is defined; 
starting a field ends the previous field at the character position prior to the new 
control character. 



All display stations may be programmed with formatted fields. The control char- 
acter at the start of each field contains the field attributes. Attributes contained in 
this character apply to all the data contained in the field. 
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Field Attributes 



The field attribute character occupies the first character position of each display 
field in a formatted display; the corresponding character position on the display 
screen is always blank. This eight bit attribute character is loaded by a Start Field 
order to define the start of a field and assign characteristics to the field. Bit posi- 
tions in the character are significant; the value assigned to each bit or group of bits 
controls whether a specific attribute is applied. 

Field Attribute Character: The following figure shows the significance of bits in the 
field attribute character. Characteristics set by the field attribute character are: 

• Protected/Unprotected: An operator cannot enter data into or modify the 
content of a protected field. Input fields that require data from the operator 
must be unprotected. 

• Alphameric/Numeric: In an unprotected input field, alphameric/numeric 
defines the type of data that an operator can enter into the field. This attribute 
has special meaning for protected fields and data entry keyboards. 

A cursor moving into a field defined with both Numeric and Protected will skip 
to the following Unprotected field. A cursor moving into a field defined as 
Alphanumeric and Protected will lock up the keyboard which requires a user 
reset to free. 

• Nondisplay /Display /Intensified: Data contained in the field is either not dis- 
played, displayed at normal intensity, or displayed at high intensity. 

• Detectable/Nondetectable: Displayed data in a detectable field can be 
selected by the CURSOR SELECT key. 

Field attributes are protected against input from the keyboard; however, bit 7 
(Modified Data Tag) is set to 1 when the operator enters data into the field defined 
by the attribute. Attribute characters are not protected against operation of the 
CLEAR key; pressing the CLEAR key erases all locations in the display buffer. 
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X 


X 


U/P 


A/N 


D/SPD 


RESERVED 


MDT 



EBCDIC 
BIT 


Field Description 


0,1 


Value determined by contents of bits 2-7. See following figure 
for hexadecimal values. 


2 


= Unprotected 

1 = Protected 


3 


= Alphameric 

1 = Numeric 

Note: Bits 2 and 3 equal to 1 1 causes an automatic skip. See 
text. 


4,5 


00 = Display/not CURSOR SELECT key detectable. 

01 = Display/CURSOR SELECT key detectable 

10 = Intensified display/CURSOR SELECT key detectable. 
11= Non-display, non-print, non-detectable. 


6 


Reserved 


7 


Modified Data Tag (MDT): identifies modified fields during 
Read Modified command operations. 

= Field has not been modified 

1 = Field has been modified by the operator. Can also be set 

by program in data stream 



Figure 6-13. Field Attribute Character Bit Assignment 
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Bits 2-7 


EBCDIC 




Bits 2-7 


EBCDIC 


00 0000 


40 




10 0000 


60 


00 0001 


CI 




10 0001 


61 


00 0010 


C2 




10 0010 


E2 


00 0011 


C3 




10 0011 


E3 


00 0100 


C4 




10 0100 


E4 


00 0101 


C5 




10 0101 


E5 


00 0110 


C6 




10 0110 


E6 


00 0111 


C7 




100111 


E7 


00 1000 


C8 




10 1000 


E8 


00 1001 


C9 




10 1001 


E9 


00 1010 


4A 




10 1010 


6A 


00 1011 


4B 




10 1011 


6B 


00 1100 


4C 




10 1100 


6C 


00 1101 


4D 




10 1101 


6D 


00 1110 


4E 




10 1110 


6E 


00 1111 


4F 




10 1111 


6F 


01 0000 


50 




110000 


F0 


01 0001 


Dl 




110001 


Fl 


01 0010 


D2 




11 0010 


F2 


01 0011 


D3 




110011 


F3 


01 0100 


D4 




110100 


F4 


01 0101 


D5 




110101 


F5 


010110 


D6 




110110 


F6 


010111 


D7 




110111 


F7 


01 1000 


D8 




11 1000 


F8 


01 1001 


D9 




11 1001 


F9 


01 1010 


5A 




11 1010 


7A 


01 1011 


5B 




11 1011 


7B 


01 1100 


5C 




11 1100 


7C 


01 1101 


5D 




11 1101 


7D 


01 1110 


5E 




11 1110 


7E 


oi mi 


5F 




ii mi 


7F 



Figure 6-14. EBCDIC Values for Attribute Characters 



6.3 IBM 7171 Printer Support 



The IBM 7171 will support ASCII printers which are functionally compatible with 
3286 printers. The 3270 Data Stream mode for controlling printers is supported 
and is described below. The SNA Character String mode is not supported. For 
example, to run as a 3286 printer on the IBM 7171, the host processor should set 
this device up as a 3286 model 2 printer (DEVTYPE=3286,MODEL=2) on the 
channel assigned to the IBM 7171. 

The format control orders CR, NL, FF, and EM can be used by a host application 
to format a printout when line length format is not specified in the WCC. The 
ASCII printer is expected to follow the conventions contained in Figure 6-15 when 
the host datastream contains these orders. 
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Order 


EBCDIC 


Explanation 


CR 


OD 


Carriage Return. Moves the print position horizontally to 
the left margin by sending an ASCII Carriage Return to 
the device. 


NL 


15 


New Line. Moves the print position horizontally to the 
left margin and vertically down to the next line. The IBM 
7171 will send an ASCII Carriage Return - Line Feed to 
the device when this order is present. 


FF 


OC 


Form Feed. Moves the print position to the top and left 
margin of the next page by sending an ASCII Form Feed 
to the device. This operation must be performed by the 
printer. No page size information is kept within the 7171. 


EM 


19 


End of Message. Terminates an unformatted print opera- 
tion. Nothing is sent to the printer as a result of this 
order. 



Figure 6-15. Printer Control Orders 

The WCC byte definition for printer use is shown in Figure 6-16. 



Bit 


Explanation 


0,1 


The function of these bits is to make the WCC byte an 
EBCDIC/ASCII translatable graphic. 


2,3 


Defines printout format as follows: 

00 - The CR, NL, or FF orders in data stream determine print 
line length, and EM designates the end of the print buffer. 
Provides a 132 character print line when orders are not present. 

01 - Specifies 40 character print line 

10 - Specifies 64 character print line 

1 1 - Specifies 80 character print line 


4 


Start Print bit. When set to 1 , initiates a printout operation at 
the completion of the write operation. 


5 


Sound Alarm bit. When set to 1, sounds the audible alarm if an 
audible alarm provided. 


6 


Keyboard Restore bit. 


7 


Reset MDT bit. 



Figure 6-16. The Write Control Character 

In normal operation, when bits 2 and 3 of the WCC are 0, a Newline function is 
performed each time a valid NL character is encountered. In addition, if no valid 
NL is encountered before the printer reaches the end of a line (as determined by 
the maximum physical carriage length), the ASCII printer itself should perform a 
NL function. The IBM 7171 will not send a NL to the printer in this situation. If 
the ASCII printer does not perform an automatic NL at the end of carriage, then 
one must be explicitly coded in the host datastream. 
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During a print operation, if line length format is specified in bits 2 and 3 of the 
WCC (bits 2 and 3 not equal to 0), data characters in the printer buffer are 
scanned one line at a time before they are printed. A Newline is executed after 
each line is printed. If a line contains only null characters and one or more space 
characters, a line feed is performed to cause a blank line in the printout. When null 
characters, field attributes, or alphanumeric characters in a nonprint field are 
encountered, they are treated as follows. 



• If in a 



line that contains another print field, they are printed as spaces. 



• If they constitute an entire line, they are ignored, and the line feed is not per- 
formed; as a result, a blank line does not appear in the printout, and the data is 
compressed vertically one line. 

CR, NL, FF, and EM are valid only when encountered in a print field during a 
printout that does not have a line length format specified by the WCC. When line 
length format is specified, and printer control characters are embedded in the data, 
they are converted to the following characters: 



NL prints as a 5 
EM prints as a 9 
CR and FF both print as a blank. 



6.4 IBM 7171 to Host Interactions 



The channel program controls all control unit operations by transmitting informa- 
tion across the I/O interface. This information consists of: 



3. 



4. 



an address byte, which selects one control unit and one device (display or 

printer) attached to the control unit, 

command bytes, which specify the type of operation to be performed by the 

control unit for that device, 

data bytes, which either are stored in the control unit buffer for ultimate use by 

the selected device as display or printout data or are decoded as orders and 

used by the control unit for formatting the buffer, and 

various control signals. 



Status bytes, which are generated by the control unit, inform the channel program 
of: 

1. the general condition of the control unit and selected device at various stages 
of command operations and 

2. of unique conditions of the control unit and any attached device when 
command operations are not in progress. 
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6.4.1 Interface Operations (IBM 71 71 /Channel) 



Selection 



Command Initiation 



Chaining 



The host program initiates control unit operations with a Start I/O instruction. 
This instruction identifies the I/O control unit and device (in this case, the control 
unit and a display/printer) and causes the channel to fetch a channel address word 
(CAW) from a fixed location in main storage. The CAW designates the storage 
protection key and the location in main storage from which the channel subse- 
quently fetches the first channel command word (CCW). The CCW specifies the 
command to be executed and the number and address, in main storage, of any 
bytes to be transmitted. 



The channel attempts to select the control unit and an attached device by sending a 
unique address byte to the control unit (and to all other control units attached to 
the same channel or subchannel). When a control unit recognizes both addresses 
(its own and its devices), it logically connects to the channel and responds to the 
selection by returning the device address byte to the channel. 



Command operations by the control unit start when the control unit and a device 
are successfully selected. When a command is to be executed by the control unit, 
the channel sends the command code (CCW bits — 7) to the control unit. 

When execution of the command involves a transfer of data (such as Write or Read 
Modified), the control unit responds to the command with a status byte (called 
initial status) indicating whether or not it can execute the command. If the 
command can be executed, the channel is set up to respond automatically to service 
requests from the control unit, and the control unit assumes further control of the 
operation. Command operation can be terminated by the control unit or when the 
channel byte count reaches 0. At this time, the control unit sends the channel a 
second status byte (called ending status) which indicates whether the command 
operation was successfully performed. 

When the function of the 3270 command does not involve the transfer of data 
(such as EAU), it is called an immediate command. The resulting control unit oper- 
ation depends on the particular command. If the command is No Operation, initial 
and ending status are combined to indicate to the channel that the control unit has 
completed execution of the command. If the command is Select or Erase All 
Unprotected, which initiates certain control unit and device operations, the initial 
status from the control unit allows the block multiplexer channel to be released to 
perform other operations. When command execution is completed by the control 
unit (and it regains selection), the control unit sends ending status to the channel, 
indicating whether the command was successfully performed. 



When the channel has completed the operations specified by a CCW, it can con- 
tinue the activity initiated by the Start I/O by fetching a new CCW, thereby 
starting execution of another command. The fetching of this new CCW is called 
command chaining, and the CCWs belonging to such a sequence are said to be 
chained. All CCWs in a chain apply to the control unit and device specified by the 
Start I/O instruction. 
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Status 



Either of two types of chaining can be specified by the current CCW (bits 32 and 
33): data chaining or command chaining. During data chaining (current CCW bit 
32=1), the new CCW fetched by the channel defines a new main storage area 
(data address) for the current command. During command chaining (current CCW 
bit 33=1), the new CCW specifies a new command and a data address for that 
new command. 

Thus, when command chaining is used, the control unit is selected following the 
Start I/O instruction when the channel receives the first CCW in the chain that 
involves operations with the control unit. The control unit is dedicated to one 
CCW string until final Channel End time or until operations are abnormally termi- 
nated. Programming restrictions that must be observed when command chaining is 
used are described in "Commands" on page 6-3. 



The control unit generates a status byte to inform the channel of certain control 
unit and device conditions. This status byte can be generated synchronously (while 
the control unit is selected and performing a command operation with the channel) 
or asynchronously (while the control unit is not selected). 

Synchronous status is passed to the channel as both both initial and ending status 
to a command. Initial status reflects the condition of the selected device and/or 
control unit upon receipt of a command, and indicates to the channel whether the 
command can be executed. Ending status reflects the condition of the control unit 
and selected device after all channel/terminal interface operations of a nonimme- 
diate command are completed. Asynchronous status reflects: 

1 . ending status for an immediate command other than No Operation, 

2. a second ending status for a Write, Erase/Write, or Erase/Write Alternate 
indicating that the control unit to device buffer transfer is completed, or 

3. an equipment condition or operator action not associated with command exe- 
cution (an attention). 

Figure 6-17 describes each bit of the status byte. Status is reset by the control unit 
once it has been accepted by the channel. 



Bit 


Name 


Condition 





Attention 
(A) 


Indicates a request for services from a terminal. 
Program should respond by issuing a Select 
command followed by the correct Read Modified 
chain. Attention bit is also set with (Unit Check) 
as a result of asynchronously detected equipment 
malfunctions; in this case, program should respond 
by issuing a Sense command. 


1 


Status Mod- 
ifier (SM) 


Set with Busy in initial status when there is 
pending status for another device in this control 
unit. 



Figure 6-17 (Part 1 of 3). Status Byte Bit Assignments 
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Bit 


Name 


Condition 


2 


Control 
Unit End 
(CUE) 


Set following a Busy condition, after pending 
status is cleared or to indicate that the control unit 
is now free to accept a new command. 


3 


Busy (B) 


Set alone in initial status byte when addressed 
device is already busy performing a command. Set 
with Status Modifier when addressed control unit 
is busy. When the channel addresses a device 
other than the one that is busy and control unit is 
not busy, addressed device becomes selected and 
the command is honored. The Busy bit is also set 
in pending status if addressed device has such 
status; if pending status is for a device other than 
the one addressed, Status Modifier bit is also set. 


4 


Channel 
End (CE) 


Indicates channel data transfer operations are 
completed. Is set alone: 

1. In initial status for Select or Erase All Unpro- 
tected command. 

2. As ending status for Write, Erase/Write, and 
Erase/Write Alternate commands; in all cases, 
Device End status is sent asynchronously 
when device operations (command execution 
or control unit to device buffer transfer) are 
completed. 

3. In initial status for No Operation command. 

4. In ending status for Read Buffer, Read Modi- 
fied, or Sense command. 

5. Asynchronously if only Channel End status 
was pending and the device operation is com- 
pleted before the channel accepts status. Is 
set with Device End and Unit Exception in 
initial status for Read or Write command if 
addressed device is busy executing another 
command. 


5 


Device End 
(DE) 


Indicates that the control unit and device have 
completed all command operations and are free to 
execute another command. Is set: 

1. In initial status for No Operation command 

2. In ending status for Read Buffer, Read Modi- 
fied, or Sense command. 

3. In asynchronous status for Write, 
Erase/Write, Erase/Write Alternate, Select, 
or Erase All Unprotected command. 



Figure 6-17 (Part 2 of 3). Status Byte Bit Assignments 
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Bit 


Name 


Condition 


6 


Unit Check 
(UC) 


Is set when an irregular program or equipment 
condition is detected by the control unit or device. 
Program should always respond to Unit Check 
status by issuing a Sense command for further 
definition of the error condition. 



Figure 6-17 (Part 3 of 3). Status Byte Bit Assignments 

The following figures list the initial, ending, and asynchronous status and sense bit 
combinations, respectively. The abbreviations used in these figures are as follows: 



Status Bits 



A - Attention 

B - Busy 

CE - Channel End 

DE - Device End 

SM - Status Modifier 

UE - Unit Exception 

UC - Unit Check 



Sense Bits 



BOC - Bus Out Check 
CC - Control Check 
CR - Command Reject 
DC - Data Check 
EC - Equipment Check 
IR - Intervention Required 
OC - Operation Check 
US - Unit Specify 



Figure 6-1 8. Status/Sense Byte Bit Assignments for the IBM 7171 

Initial Status: Initial status is generated by the control unit in response to initial 
selection by the channel. During the initial selection sequence, the status byte is 
sent to the channel after the control unit receives a command. 
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Status 
(Hex) 


Sense 
(Hex) 


Error 

Recovery 

Procedure 


Condition 


All Zeros (00) 






Normal status for any command other 
than No Operation, Select, or Erase 
all Unprotected. 


CE (08) 






Normal status for a Select or Erase 
All Unprotected command. 


CE,DE (0C) 






Normal status for a No Operation 
command. 


UC (02) 


BOC (20) 


1 


A parity error was detected on the 
command byte. 


UC (02) 


IR (40) 


2 


A command other than Sense was 
addressed to a device that the control 
unit has recorded as unavailable or 
not ready. 


UC (02) 


CR (80) 


3 


An invalid command was issued to the 
control unit. 


B(10) 






Response to a command addressed to 
a device which is being serviced by 
the control unit or which is com- 
pleting a previously issued command. 


B,SM (50) 






Response to a command addressed to 
a device other than device whose 
status is pending or device being ser- 
viced by the control unit. 



Figure 6-19. Initial Status and Sense Conditions 



This figure shows the possible initial status bit configurations. An all zero status 
byte is sent when a nonimmediate command is accepted for execution by the 
control unit; it is also sent in response to Test I/O if other status is not pending. 
The Unit Check bit is set if the command is not accepted by the control unit 
because of a program or equipment error. 

Initial status to immediate commands is as follows. For No Operation, Channel 
End and Device End are both set to indicate completion of the command. For 
Select and Erase All Unprotected, which do not involve data transfer between the 
channel and the control unit, Channel End is set. This frees the block multiplexer 
channel for other operations while the command is being executed. When 
command execution is completed, ending status is presented asynchronously. 

If a Start I/O Fast Release (SIOF) is executed by the channel, then unchained 
initial status becomes ending status. 

When status is pending (a previous status byte is awaiting transfer to the channel), 
the pending status byte, with the Busy bit set, is sent to the channel in response to 
any command (except a Test I/O instruction), and that command is not accepted 
by the control unit. For Test I/O, the pending status byte is presented without the 
Busy bit set. If the pending status is for a device other than the one selected during 
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the initial command sequence, only Busy, Status Modifier is presented to the 
channel and the pending status is retained by the control unit. 

Ending Status: When the control unit completes channel operations for a nonim- 
mediate command, it sends an ending status byte to the channel, freeing the 
channel for other operations. This status byte always relates to the command oper- 
ation that has been executed. The normal ending status byte for a Read Buffer, 
Read Modified, or Sense command will have only the Channel End and Device 
End bits set, indicating that the command has been executed. Normal ending 
status for a Write, Erase/Write, or Erase/Write Alternate command is Channel 
End alone. When the control unit to device buffer transfer is completed, ending 
the command operation, Device End status is sent to the channel as asynchronous 
status. Any error condition associated with the operation just executed will cause 
additional status bits to be set. Ending status causes an I/O interruption unless 
chaining is specified. 

When the control unit has pending status, it attempts to gain selection of the 
channel asynchronously to pass this status. It is passed to the channel either when 
selection is accomplished or as initial status for the next command (with the Busy 
bit set), whichever occurs first. 



Status 
(Hex) 


Sense 
(Hex) 


Error 

Recovery 

Procedure 


Condition 


CE (08) 






Set at the end of a channel to control 
unit transfer of a data stream on a 
Write, Erase/Write or Erase/Write 
Alternate command. 


CE,DE (OC) 






Set at the end of a channel to control 
unit transfer of a data stream on a 
Read Buffer, Read Modified, or Sense 
command, or when the channel byte 
count goes to zero on a Read Buffer 
or Read Modified command. 


CE,DE,UC (0E) 


BOC (20) 


4 


The control unit detected a parity 
error on a character in data stream of 
a Write, Erase/Write, or Erase/Write 
Alternate command. 


CE,DE,UC (0E) 


DC/US (OC) 


1 


The IBM 7171 disabled the device 
because of an error. (UC, IR is 
reported on the retry since the device 
requires a Power On Reset to be re- 
enabled). 



Figure 6-20. Ending Status and Sense Conditions 
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Asynchronous Status: Asynchronous status reflects: 

1. the ending status of an immediate command other than No Operation, 

2. the second ending status for a Write, Erase/Write, or Erase/Write Alternate 
command, indicating that all command initiated operations are completed, 

3. an action by the device operator that requires program intervention (attention 
status), or 

4. a control unit or attached device equipment malfunction. 

When an asynchronous status condition occurs, the control unit attempts to gain 
selection by the channel, and passes this status to the channel when selection is 
accomplished. This status is called pending status until selection is accomplished. 
If the channel issues a command before retrieving this pending status, the pending 
status is returned, with the Busy bit set, in place of initial status for the command; 
in this case, the command is not executed, unless it is a Test I/O instruction. 

When an asynchronous condition occurs at a device while the control unit is per- 
forming command operations with another device, the asynchronous status remains 
pending until the control unit completes the current command operation, returns 
ending status to the channel, and becomes not busy. The control unit then 
retrieves the pending status from the device and attempts to present it to the 
channel in the same manner as other asynchronous status. 

Some other conditions of multiple status that can occur are not covered here. 
These conditions can be caused by multiple error conditions occurring simultane- 
ously. 
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Status 
(Hex) 


Sense 
(Hex) 


Error 

Recovery 

Procedure 


Condition 


A (80) 






An attention generating action (e.g., 
program access key has been 
depressed) was performed by the 
operator. 


DE (04) 






The control unit to device buffer 
transfer is completed on a Write, 
Erase/Write, or Erase/Write Alter- 
nate command. 

The device becomes not busy after 
completing an Erase All Unprotected 
command. 

The device to control unit buffer 
transfer is completed on a Select 
command. 

A device changes from not available 
to available or from not ready to 
ready. 


DE,UC (06) 


OC (01) 


3 


A Write, Erase/Write, or Erase Write 
Alternate command containing a 
WCC with the Start Print bit set is 
chained to a subsequent command. 

The IBM 7171 received an invalid 
buffer address in the data stream of a 
write type command, or the data 
stream ended before providing all 
characters required for an SBA, RA, 
SF, GE, or EUA order on a write 
type command. A portion of the 
device buffer may have been changed. 


CUE (20) 






The control unit had been addressed 
while busy, but is now not busy and is 
free to accept a new command. 



Figure 6-21. Asynchronous Status and Sense Conditions 
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6.4.2 Error Recovery Procedures 



IBM 7171 Device Detected Errors 



Error conditions detected by the IBM 7171 or by an attached device are indicated 
to the program by Unit Check status. The program must respond to this status by 
using a Sense command for further definition of the condition. If a Sense 
command is not performed and the sense conditions still exist, the control unit will 
not honor any other interrupts from the device. Subsequent recovery operations 
are then determined by the combined configurations of Unit Check status bits and 
associated sense bits. 



Referenced Error Recovery Procedures 



Inbound Transmissions 



The recovery procedures referenced in the Error Recovery Procedure column of 
Figure 6-19, Figure 6-20, and Figure 6-21 are as follows: 

1 . Reconstruct the entire buffer image and retry the failing chain of commands. 
The sequence of commands used to reconstruct this image should start with an 
Erase/Write command. If, after two retries, the problem is not corrected, 
follow procedure 5. 

2. The error indicates the device is unavailable. Request and wait for operator 
intervention to ready the device and upon receipt of Device End status, retry 
the chain of commands. 

3. A nonrecoverable program error has occurred. Examine the data stream to 
locate the problem. 

4. Retry the failing chain of commands. If, after two retries, the problem is not 
corrected, follow procedure 1. A Write command can be retried if new fields 
have not been created in the buffer portion which has been cleared by a 
Program Tab or Erase Unprotected to Address order. 

5. Request maintenance for the device that is giving trouble. After the repair, 
reconstruct the buffer image, starting with an Erase/Write command. 



Terminals are put in a keyboard lock state when an AID generating key (such as an 
Enter) is hit. This can be reset by a Write, Erase/Write, or Erase/Write Alternate 
with the WCC Keyboard Reset bit on, or by the terminal operator sending a Reset 
sequence. During this time the screen can not be modified and multiple Reads will 
get the same data. As an example, terminal users know there is a system problem 
when their keyboards remain locked because the host did not issue a keyboard 
unlocking Write. 

Inbound transmissions result from an operator Enter action, a host initiated (unso- 
licited) read request, or a host retry of an inbound transmission. 

An operator Enter action is one that causes an attention identifier (AID) to be 
transmitted inbound. The host program responds with a read request. The host 
program must acknowledge the inbound transmission before a new inbound opera- 
tion can be performed. 
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A host initiated read operation is an inbound transmission not caused by an oper- 
ator Enter action. No host acknowledgment is required before a new inbound 
transmission can occur. 

Host retry is a retransmission of the last unacknowledged inbound transmission 
from the device. The host must acknowledge reception of an inbound transmission 
before a new inbound transmission can take place. A host retry transmission does 
not cause read state transitions and is not considered a new inbound transmission 
requiring host acknowledgment. Host retry occurs until a host acknowledgment 
takes place. 

The type of inbound transmission is data from the device buffer (for example, 
modified fields of the display image). An inbound operation device characteristic 
(INOP), set by the controller, defines the type. 

Inbound Operation Device Characteristic (INOP): The device characteristic INOP 
determines the operation to be performed when data is transmitted inbound on a 
retry transmission, or when the device is in a data pending state. 

INOP is set by any of the following: 

• An operator Enter action sets INOP to Read Modified. 

• Host acknowledgment of an inbound transmission sets INOP to Read Modi- 
fied. 

Read States: While powered on, a device is in one of three states with respect to 
read operations. The three states are: Normal, Data Pending, and Retry. The 
events that cause transitions between the states are shown in Figure 6-22. 

Normal Read State. A device is in Normal read state when powered on, or prior to 
initiation of a new read operation, or after use of the Reset key in certain instances 
(see Figure 6-22). 

When in Normal read state, an operator Enter action causes the device to prepare 
to generate the inbound data stream and to go into a Data Pending state. 

A host initiated read operation causes the data to be transmitted with no state tran- 
sitions occurring. The device remains in Normal read state. 
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Data Pending State. 

• Data Pending Enter: the device state after an operator Enter action occurred. 

A read command received while the device is in a data pending state causes the 
data to be transmitted and the device to be placed in the Retry state. (See 
Figure 6-22.) 

Retry State. 

• Retry Enter: the device state after the entered data was transmitted to the host. 

While in a retry state, the last inbound transmission can be retried by means of a 
Read Modified command. 

A host acknowledgment causes the device to revert from a retry state to the normal 
read state. 



EVENTS 


NORMAL 


DATA PENDING 


RETRY 




(1) 


(2) 


(3) 


Enter Action 


2 


R 


R 


Read Command 


1 


3 


3 


Host 








acknowledgement 


- 


1 


1 


Reset key 


- 


1 


1 



R = Reject , no state transition. 
- = No action, no state transition. 

Figure 6-22. Read State Transitions 

The typical scenario would be to be in Normal state and get an Enter action (user 
hit enter at terminal). The terminal would switch to Data Pending state. Next, a 
Read command would switch the terminal to Retry state. Next, a Write command 
containing a WCC with the Keyboard Reset bit set would be processed, putting the 
terminal back into Normal state. 

Host Acknowledgments: After inbound transmissions resulting from operator Enter 
actions, the transmission must be acknowledged before a new inbound operation 
can be performed. 

For inbound transmissions generated by operator Enter actions, the following are 
host acknowledgments: 

• A Write, Erase/Write or Erase/Write Alternate command containing a WCC 
with the keyboard restore bit set to 1 , or an Erase All Unprotected command. 

• Any write transmission when the device is in Data Pending read state. 
Host acknowledgment resets INOP to Read Modified. 
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Processing of Read Commands: Read commands (Read Modified, Read Buffer) are 
processed as follows. 

1. If the device is in Normal read state, then: 

a. Data is transmitted inbound as defined by: 

(1) The command (Read Modified, Read Buffer) 

(2) The AID (Read Modified command only). 
The device remains in Normal read state. 

2. If the device is in a Data Pending state then: 

a. If the command is Read Modified and INOP specifies Read Modified, then 
data is transmitted as defined by: 

(1) The Read Modified command 

(2) The AID. 

b. If the command is Read Buffer, then data is transmitted as defined by: 
(1) The command. 

For items a and b, the device is placed Retry state. 

3. If the device is in a Retry state, then a retry is performed as follows: 

a. If the command is Read Modified and INOP specifies Read Modified, then 
data is transmitted as defined by: 

(1) The Read Modified command 

(2) The AID. 

b. If the command is Read Buffer, then data is transmitted as defined by: 
(1) The command. 

For items a and b, the device remains in the retry state. 
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Keyboard Action or 




Data Stream states 


INOP 


Clear key 


R 


System Request key 


R 


TEST key 'ENTER' 


R 


TEST key 'EXIT' 


R 


Write or E/W with WCC bit 1 on 


R 


Power on 


R 


R- Reset NC - No Change 





Figure 6-23. Reset Matrix 



6.4.3 Special Order Strings 



Transparent Mode 



The IBM 7171 provides a transparent interface to ASCII devices. In addition, 
special order strings beginning with X ' 2B5B ' allow definition of most of the 
extended functions supported by the IBM 7171. 

• Programming an ASCII device transparently from the host - Some ASCII hard- 
copy and graphic devices cannot easily simulate a 3270 screen, nor is it desir- 
able for them to do so. It is possible to program them from the host through a 
special data stream. 

• Using Setup Functions - The extended functions provided by the IBM 7171 are 
normally initiated by keystrokes entered at the terminal. However, it is some- 
times desirable to have the host application program set up most of these 
extended functions via programming. "Setup Functions for Host Application 
Programs" on page 6-40 gives details on how to do this. 



A transparent mode request introducer sequence at the beginning of a datastream 
causes the remaining data to be transmitted to the ASCII device "as is." While the 
WCC and the six characters of the introducer conform to the normal structure of 
•3270 orders, the rest of the data is treated as 7-bit ASCII. The high order bit is 
ignored. It is recommended that the high order bit be turned on for every character 
to "relocate" everything into the range X ' 80 ' -X ' FF ' , which is treated as ordi- 
nary graphic characters by the TP access methods. In VM/SP the fullscreen Diag- 
nose interface should be used to transmit the data. 

Write: The Transparent Write introducer consists of two SB A sequences: 

X' 115D7F110000' 

When encountered by the IBM 7171, the rest of the buffer is flagged as a Trans- 
parent Write request. Since no data editing is performed, any required control 
characters must be supplied in the data stream, including carriage return, line feed, 
or padding. The IBM 7171 will still perform pacing character (eg. XON/XOFF) 
processing during the transmission, provided pacing is enabled. Therefore, padding 
characters need not be coded for terminals which use a pacing character protocol. 
While in transparent mode, the IBM 7171 still receives characters from the ter- 
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minal. The special reset characters are processed immediately and are a means of 
escape from a host application that has failed. These are the only keys which can 
alter the absolute host control over the output data. If the logical keyboard lock 
state applies, other characters received from the terminal are not processed and 
remain in the typeahead buffer. If the keyboard is logically unlocked, characters 
are examined as received and discarded. While in transparent mode, no ordinary 
characters or edit requests from the keyboard are accepted. However, attention 
generating keys will be parsed and their AID value remembered. 

When all this data has been processed, the IBM 7171 will generate an attention 
interrupt to the host for this device address. This signals the host that another 
buffer can be transmitted to the device. If the host application issues another write 
to the device before receiving the attention interrupt, the previous data may be 
overwritten with unpredictable results. 

If the host responds to this attention interrupt with a Read Buffer or Read Modi- 
fied command, the IBM 7171 will respond with the null AID for 328x printers 
(X ' E8 ' ), followed by the current cursor address pointing to the byte following the 
last data sent. If the ASCII device has a keyboard, and the keyboard is unlocked 
by the WCC beginning the write, then it is possible to change this AID value by 
pressing any of the attention generating keys (ENTER, PFK, or PA). All other 
input will be ignored. 

After signalling the end of data transmission, the IBM 7171 remains in transparent 
mode until the next host output is received. This insures that spurious characters 
are not introduced in the output data stream between two consecutive buffers of 
transparent output data. However, this also means that input is parsed and dis- 
carded, and while attention generating keys will be recognized, the only action will 
be to save their AID for the response to the next buffer of transparent data. No 
second attention interrupt will be generated. It is also not possible to generate a 
beep in this state, so input errors like line noise and buffer overrun are not signalled 
at this time. If the errors have not been reset in the interim, the beep will sound 
when transparent mode ends. 

If the host application wishes to send another buffer of transparent data after 
having received the attention acknowledging the receipt of the previous buffer, it 
simply builds a new buffer beginning with a WCC and the transparent mode 
introducer sequence and issues another output request. If the write operation that 
enters Transparent Write mode is an Erase/ Write operation, then the Clear Screen 
CSS defined for that device will be sent before the transparent data. If the opera- 
tion is an Erase/Write Alternate, then the Alternate Clear Screen CSS will be sent 
before the transparent data. In addition, the 3270 alternate screen size buffer will 
be used. If an Erase/Write or an Erase/Write Alternate command is used while 
the device is already in Transparent mode, no screen erasure or buffer size 
switching will take place. For example, if a terminal type defined to be a 3278 
Model 5 uses a Write or Erase/ Write to enter Transparent mode, a 1920 byte 
buffer is available for transparent data. If Transparent mode is entered with 
Erase/Write Alternate, then a 3564 byte buffer is available for use. 

TSO generally requires the output to end with an Insert Cursor order. If an appli- 
cation program does not supply it, TSO may transmit one itself, disrupting the 
transparent protocol. Therefore, if the last character in the data stream is an Insert 
Cursor order, it is logically removed from the data count and is not transmitted to 
the device. 
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Transparent mode is ended by either a Master Reset sequence received from the 
keyboard or a non-transparent write from the host. A non-transparent write is one 
which contains more than the WCC and does not begin with the transparent mode 
introducer sequence. It is recommended that an application program issue a non- 
transparent write at the end before returning to the normal TSO or CMS environ- 
ment. A null WCC followed by an SB A to the upper left corner (X ' 401 14040 * ) 
will serve nicely to end transparent mode. If Transparent mode is ended by a 
Master Reset from the keyboard or a Write command from the host, the device 
screen will not be cleared. If Erase/Write or Erase/Write Alternate is used, then 
the device screen will be cleared and operation will resume in the mode selected. 

Write /Read: A second form of transparent mode is the "Transparent 
Write/Read," which may be specified with either of the following SBA sequences: 

X' 115D7F110001 ' or X ' 1 1 5D7F1 10005 ' 

When this form is used, the IBM 7171 will enter transparent mode and transmit the 
data to the device as in normal transparent write mode. When all data has been 
transmitted to the device, all characters sent by the device in response will be 
received and saved. This receive is terminated by the receipt of an ASCII Carriage 
Return, the Master Reset sequence as defined in the active terminal definition 
table, or by receipt of more than a screen sized buffer of data. Pacing stop (as 
defined in the active terminal definition table) is also by default an ending condi- 
tion for Transparent Write/Read, but this can be disabled by setting the X' 10 ' bit 
in the System Control Flags contained in NV-RAM. Refer to section 4.4.1, "Data 
Area 1 Layout" on page 4-20 for the location of the flags, and to 
Chapter 9, "Special Maintenance Facility and System Messages" on page 9-1 for 
the Maintenance Facility Display and Store commands required to set the flag. 

Upon presentation of the automatic attention interrupt, the host must perform a 
Read Modified command. Data will be returned in Read Buffer-like format. A 
null AID X ' E8 ' will be followed by a cursor address pointing to the byte following 
the last received data, followed by the data in seven bit ASCII, with the X ' 80 ' bit 
set on in each byte. All input will be ignored during the transmission of the write 
data, and all characters received during the read (including erroneous characters 
and the terminating character) will be presented to the host. After the termination 
character is received, the terminal is left in transparent mode. If the 7171 input 
buffers are overrun by the device, then it will also present an Attention interrupt. 
The AID returned by the mandatory Read Modified will be X ' E4 ' to indicate the 
error. Transparent Write/Read is intended for PC file transfer protocols or for 
limited interactive functions such as reading crosshair positions on a graphics 
device. 



Setup Functions for Host Application Programs 



The extended functions are mostly setup functions that can also be initiated from a 
host application program using a special order. Special orders are defined using the 
convention X ' 2B ' followed by a dollar sign ("$" or X ' 5B ' ) followed by one or 
more characters. Additional setup functions defined specifically for use by host 
application programs are described below. A list of the special orders available to a 
host application program is shown in Figure 6-24 on page 6-41. 
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2B5B81 APLModeOn 

2B5BC1 APL Mode Off 

2B5B95 3270 Null Processing 

2B5BD5 Improved Null Processing 

2B5BA9 Zones Mode On 

2B5BE9 Zones Mode Off 

2B5B85 Reverse Enter/New Line Keys 

2B5BC5 Restore Enter/New Line Keys 

2B5B83 Reverse Column and Field Tab Keys 

2B5BC3 Restore Column and Field Tab Keys 

2B5B97 Restore Pacing 

2B5BD7 Suppress Pacing 

2B5BA5 Alpha in Numeric Only Field 

2B5BE5 3270 Numeric Only Fields 

2B5B89 3278 Insert Mode (cancel insert across attention) 

2B5BC9 3277 Insert Mode (maintain insert across attention) 

2B5B84 Alternate Display of Attributes 

2B5BC4 Primary Display of Attributes 

2B5BE3 Set Home Line, Set Left Margin, Set Column Tabs 

2B5BB0xx Set Mark 'xx' at Current Buffer Address 

2B5BB4 Clear Mark 

2B5BA2 Enable Asynchronous Status Change Notification 

2B5BE2 Disable Asynchronous Status Change Notification 

2B5BBC Request Type 1 Status Message 

2B5BBD Reserved 

2B5BBE Request Type 1 Status Message with Attention 

2B5BBF Reserved 

2B5B4B Host Initiated Line Drop 

Figure 6-24. List of Special Orders for Extended Functions 

The setup functions in Figure 6-24 which are not described below have already 
been described in section 3.1.6, "Setup Functions" on page 3-3. The setup func- 
tions "set column tab," "set left margin," and "set home line," which can be exe- 
cuted by pressing the predefined key sequence on the ASCII terminal keyboard 
have no individual special orders assigned. Instead, a complex string is used to 
define these setup functions as described under "Set Home Line, Set Left Margin, 
Set Column Tabs" on page 6-42. 

Most of these options provide convenience features for users. For example, there 
may be a difference between the preferred keyboard assignment for different 
phases of an application. Consider a text retrieval and text entry application where 
the terminal user first enters a search criterion into a formatted data entry menu 
screen with usual 3270 fields, then is presented with part of a text document which 
can be edited in "power typing" mode with almost no field boundary definitions at 
all. Most keyboards have a big TAB and RETURN key and possibly nothing else 
suitable for frequent usage. These order strings would allow the TAB key to be 
Field Tab on the formatted menu entry screen and Column Tab on the power 
typing text entry screen. Similarly, RETURN could be New Line on the formatted 
screen and ENTER on the text screen, or vice versa. By default everything (except 
improved null processing) starts out like a normal 3278 and the keys do not shift 
around except when the program or terminal user requests them to. 
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Set Home Line, Set Left Margin, Set Column Tabs: There is one complex string 
beginning X • 2B5BE3 ' . These introducer characters are then followed by up to 30 
additional bytes of parameter data: 

Char# Function 

1 Home line number 

2 Left margin column 
3-30 Column tab stops 

Each byte is formed by the binary line or column number added to the X • 40 ' 
blank character. Thus the sequence 

2B5BE34149494F 

would set home (X ' 41 * ) to the second row (first unprotected character position), 
the new line left margin (X ' 49 ' ) to column 10, and tab stops at columns 10 and 
16 (X ' 494F ' ). If the write buffer does not extend to include a full 28 tab stops, 
only the tab stops specified will be set. The host string fully replaces all previous 
tab stop settings. There is no way to merge new tab stops with existing tab stops 
under host control. If any value in this string is out of range or out of order the rest 
of the string is ignored, but all values set up to that point are preserved. 

Set Mark: Using the special order string "Set Mark of 'xx' at Current Buffer 
Address," the host application can "overlay" a single character at the current 
buffer address on the screen with the "mark" character specified after the X ' B0 ' 
order. The mark is invisible to the host; a host read will only receive the actual 
"underlying" character. 

Clear Mark: With the special order string "Clear Mark," the host application can 
clear the mark previously set by the "Set Mark" order. After the mark has been 
cleared, the original contents of the screen position reappears. 

Multiple Setup Format: It is possible to include several setup "orders" following a 
single x ' 2B5B ' sequence by bracketing them with "$" (x ' 5B ' ) characters. It is 
important in this case to code each order string at its full length, since x ' 5B ' could 
also occur as valid data within an order string. In other words, all 28 tabs must be 
included (even if they are x ' 40 ' ; see below). 

For example, the following extended setup order might occur imbedded in a write 
buffer: 

Hex . . . 2B5B5BC5B05BE34149494F5B4040. . .405B . . . 
Char. $ $ E $ T $ $ 

Labels EEBRM THNttttt. . .t B 

The sequence begins with the special escape sequence (labeled E), followed by the 
first of the two bracketing characters (labeled B), then an order to restore 
Enter/New Line (labeled R). Next is a Set Mark order (labeled M) followed by 
the mark character ("$"), and finally, an order to establish Home (H), New Line 
(N) and column tabs (t 1 1 . . .). Note that there must be exactly 28 tabs (since this 
is a bracketed sequence) and that "$" may be one of them (meaning column 27). 
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Terminal Status Reporting: The host may request certain status information about 
the terminal from the IBM 7171. If a status request order string is included any- 
where in a buffer written to the terminal, the IBM 7171 will be primed to respond 
to the next host Read Modified command with a status message. This message 
begins with a special AID byte (X'E4' for status 1, X ' E5 • reserved), followed by 
the cursor address as usual. The remainder of the message is returned as follows: 



• Status 1 - begins with an SBA byte, followed by the address of the "mark," if 
any, or screen address zero (x ' 4040 ' ). Then, as contents of the "field," a 
multiple setup format string describing the current state of all host settable 
options is returned. The format of this string is such that, if appended to a 
WCC and sent to the terminal, it will re-establish the current status with 
respect to all reported modes. For example, the following string might be 
returned: 

Hex 1 1C1502B5B5BB06CD5A9C583A2E597C189C4 
Char. $$ %NzEcsVpAiD 

Label SBA cont. below 

Hex E3424A454A4F54595E63686D72777C4040. . .405B' 
Char . T $ 

Label (home, new line, £ 28 column tabs) 

The string will always be 49 or 50 characters long, depending on whether 
"mark" is turned on, and will include all 28 tabs, with trailing x ' 40 ' characters 
for undefined entries. 

• Status 2 - Reserved 

Status may be requested with or without attention. Thus the host program may 
specify that the IBM 7171 is to generate an attention immediately after receiving 
the buffer containing the status request. The host may then respond with a Read 
Modified, and read the status response. Alternately, the host may perform the 
Read Modified chained to or immediately following the write containing the status 
request, without requesting or waiting for an attention. 

Note: Status should not be requested while the keyboard is logically unlocked, as 
keyboard generated attentions and AID bytes may be confused with status reports. 
If the attention generating form of status request were used while the keyboard 
were unlocked, attentions would occasionally be lost. 

Asynchronous Status Change Notification: The host program may receive notifica- 
tion of changes in terminal status caused by the keyboard operator. When Asyn- 
chronous Status Change Notification is enabled, any keyboard initiated change in 
status will cause the two high order bits of the first address byte in the cursor 
address field of the next Read Modified buffer sent to the host to be set to 

B ' 10 ' (a value which is formally illegal and reserved, but which is seldom 

checked). The host application may then request status and observe changes since 
an earlier request. 

Host Initiated Line Drop: The special order string X ' 2B5B4B ' occurring anywhere 
in an output buffer will cause the IBM 7171 to drop the communication line to the 
terminal after the entire buffer has been read out. This will have the effect of 
hanging up the phone on a dialup connection. The IBM 7171 then re-enables the 
line to permit another user to dial up. 
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Chapter 7. IBM 7171 Diagnostics 



7.1 Diagnostics Overview 



This section describes IBM 7171 Resident Diagnostics which are run when the 
IBM 7171 power is turned on. The power-on sequence automatically starts the 
execution of the Basic Assurance Diagnostic Tests (BAT) contained in ROMs 
located on the CC board, the CPU board and each TC board. Successful com- 
pletion of the Diagnostic Tests results in the system becoming operational and the 
IBM 7171 Ready light being turned on. Error conditions are indicated by lights on 
the TC boards, the CPU board, and the CC board. 



7.2 System Description 



Figure 7-1 below shows the manner of invoking diagnostics. 
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Figure 7-1. Power-on Basic Assurance Test 



Basic assurance tests are run in two phases. In the first phase tests are conducted 
within each board containing a microprocessor (the CC board,the CPU board and 
the TC boards). These tests cover hardware internal to each Customer Replace- 
able Unit (CRU) containing a microprocessor except for the CC which also tests 
the CA board. In the second phase, cross board tests are under control of the CPU 
board which checks the interface between it and the TC boards and between it and 
the CC board. 



Chapter 7 . IBM 7171 Diagnostics 7-1 



After the CPU diagnostic microcode has verified the successful completion of all 
cross board tests it will transfer control to the operational microcode and turn on 
the IBM 7171 Ready light. 



7.3 Error Conditions 



If the Ready indicator does not light, it is an indication to the customer that a mal- 
function exists in the IBM 7171. In most instances, the failure can be found by the 
operator using the Problem Determination Procedure (PDP) which is described in 
Chapter 8 of this manual. 
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Chapter 8. Problem Determination 



This chapter describes how to isolate problems with the IBM 7171. Included, is a 
detailed procedure for resolving diagnostic, power and intermittent failures. Also 
addressed, are some of the more common setup problems, which are typically a 
result of incorrect cabling or configuring of a device attached to the IBM 7171, or 
the cabling or configuring of the IBM 7171 attached to the host processor. 

If a problem exists, do the following: 

1. Go to the "Symptom Index" on page 8-2, to find the symptom. 

2. Go to the section indicated to the right of the symptom. 

3. Perform the step-by-step procedure associated with the symptom. 



8.1.1 Assistance for Problem Determination. 



If problem determination procedures cannot be completed, then contact IBM for 
Service or Assistance. 

• Prepare to provide the following information. 

— Machine (IBM 7171) Configuration (number of ports) 

— Serial number of the IBM 7171 

— Symptom (description of problem) 

— Host type (model) 

— Host Operating System installed 

— Channel & Control Unit address range 

— Company name, callers name, phone number for returning call. 



Chapter 8. Problem Determination 8-1 



Symptom Index 



Locate symptom in the following list; then go to the symptom code indicated to the 
right. The symptom codes follow the Symptom Index within this chapter. If the 
symptom is not found in the list, or, it can't be resolved through the procedure, 
then contact IBM for assistance. (Reference 8.1.1, "Assistance for Problem 
Determination.") 

Front End (TCC/CPU) related symptoms. 

Unexpected or intermittent line drop (line disconnect) F-1 

Garbled data at terminal screen F-2 

Double characters 'Echoed' to the screen F-2 

Autobaud related problems F-3 

Port doesn't restart automatically F-4 

No data sent to terminal screen. (Enter Terminal Type-.) F-5 

Specific range of ports can't present data to attached devices. F-6 
Screen problems appear after entering the valid terminal type..F-7 

Modem Related problems, (strapping/configuring) F-8 

Printer overruns on data from host F-9 

Power Indicator does not turn on at Front Panel F-10 

Diagnostic failure at power-up. (red light(s) No Ready Light). F-1 1 
Intermittent Power or Diagnostic failures F-1 2 



Channel End (CA/CCC/CPU) related symptoms. 

Can ' t VARY ONLINE or ENABLE device C- 1 

Cursor to bottom right after 

ENTER TERMINAL TYPE C-2 

Interface Control Checks 

GOT STATUS OF WRONG DEVICE 

WHEN CHANNEL EXPECTED STATUS 

FROM ANOTHER DEVICE C-3 

7171 locks up on first readying 

terminal with first write command C-4 

READY drops when 7171 switched online C-5 

Operational checks for a 7171 device C-6 
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F-l: Unexpected or Intermittent Line drops. 

• If Locally Attached (direct connection) PHYSICAL CONNECTION: 

1. Confirm that cable wiring conforms to description in IBM 71 71 ASCII 
Device Attachment Control Unit Description and Planning Guide (Appendix 
B). 

- or - 

2. Explicitly configure the port to 'Locally Attached' Refer to section 
9.8, "C - Configure IBM 7171 Ports" on page 9-7 of this manual. 

. If Switched Network PHYSICAL CONNECTION: 

1 . Confirm that cable wiring conforms to description in IBM 71 71 ASCII 
Device Attachment Control Unit Description and Planning Guide (Appendix 
B). 

. If Leased Line PHYSICAL CONNECTION: 

1. Confirm that cable wiring conforms to description in IBM 71 71 ASCII 
Device Attachment Control Unit Description and Planning Guide (Appendix 
B). 

- or - 

2. Explicitly configure the port to 'Leased Line' Refer to section 9.8, "C - 
Configure IBM 7171 Ports" on page 9-7 of this manual. 
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F-2: Garbled data at terminal screen, Double characters echoed. 

Line speed and/or line control parameters are inconsistent with attached device. 

The line control parameters the port is initialized with, must be consistent with the 
attached device. The IBM 7171 is shipped with the following default line control 
parameters defined for all ports. 

Port is reset to these settings when the IBM 7171 is powered on, or receives a 
channel reset. 

Seven data bits (7) 

Even parity 

One stop bit 

The 'line control parameters' must be consistent with those of the attached device. 
Reference the documentation (for attached device) for details on checking or mod- 
ifying the line control parameter s. 

Verify that the attached device is configured for RS-232-C, asynchronous, full 
duplex operation. (Half -Duplex configuration may cause double character echo for 
each key depressed.) To confirm and/or modify the IBM 7171 line control param- 
eters, refer to section 9.8, "C - Configure IBM 7171 Ports" on page 9-7 of this 
manual. 



Terminal Type Specification Errors 



If no device type is specified for a terminal in Non- Volatile RAM (NV-RAM), the 
IBM 7171 assumes that the device is a terminal, and requests the terminal type 
from the user. If the wrong type (one that does not match the terminal) is entered 
even though it is a valid terminal type, the IBM 7171 will use the wrong Terminal 
Definition Table. This will probably result in the terminal malfunctioning. 

To correct this situation, press the "Return to ENTER TERMINAL TYPE 
Message:" key as described in "Return to 'ENTER TERMINAL TYPE:' Message" 
on page 3-10. 

If the user cannot get back to the "ENTER TERMINAL TYPE:" message via 
entries at the keyboard, he must cause the IBM 7171 to restart the communication 
line. This can be done for a locally attached terminal by powering the terminal off. 
For remotely connected lines, intervening communications equipment (modems, 
port selectors, etc.) may prevent proper restart when the terminal is powered on 
and off. 

Under no circumstances will the MASTER RESET function defined in section 
3.1.7, "Local Reset and Control Facilities" on page 3-10 be useful in recovering 
from an incorrectly chosen terminal type table. 



8 -4 IBM 7171 Reference Manual and Programming Guide 



F-3: Autobaud related problems. 

Define the line speed explicitly to the IBM 7171 and re-attempt the connection. If 
this resolves the link problem, then confirm the following points have been 
satisfied: 

1 . The line speed that the attached device uses for the connection must be a sup- 
ported 'Autobaud' line speed. Refer to Chapter 5 of this manual for supported 
speeds. 

2. Verify that the first character transmitted by the attached device, is a 'Carriage 
Return'or (x'OD') 

3. Verify that the cable length conforms to RS-232-C. (Generally less than 50 
feet.) This is with respect to the RS232-C cables between modems, and the 
device. In the case of Locally Attached devices, the direct connect cable 
should conform to RS-232-C specifications. 



F-4: Port doesn't restart automatically. 

Confirm the following: 

1. Refer to section F-l. Verify cabling and configuring information. 

2. For Switched Network Modem attachment, verify that Data Set Ready (pin 
#6) is dropped for a minimum of 200 milliseconds, between sessions. 

3. For Leased Line Modems, verify that DSR is dropped. 

• In the event that DSR can't be dropped, explicitly configure the port as 
Leased Line, refer to section 9.8, "C - Configure IBM 7171 Ports" on 
page 9-7 of this manual. 
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F-5: No data sent to terminal. 

This section addresses the situation where no data can be sent to a terminal. (IBM 
7171 output of any form.) If any of the following local IBM 7171 functions can 
can be completed, then the local connection to the IBM 7171 is effective. 

• Character depressed, is echoed by the IBM 7171. (Confirm that the attached 
device is not echoing characters locally i.e. half -duplex) 

• 'Enter Terminal type:' displayed. 

• Host data on screen. 

— Host status message displayed or a partial 'Logo' displayed. 

— Send a note to the port in question, using the note command. Refer to 
section 9.20, "N - Send Notes to Attached Terminals" on page 9-23 of 
this manual. 

No data sent to terminal. (ENTER TERMINAL TYPE:) 

Prior to sending the attached terminal the 'ENTER TERMINAL TYPE' message, a 
number of events must take place. 

1 . The 'ENTER TERMINAL TYPE: ' message, will not be displayed, if the port 
has been dedicated to a specific terminal type. Refer to section 9.8, "C - Con- 
figure IBM 7171 Ports" on page 9-7 of this manual. The default setting will 
result, after satisfying the 'Autobaud' function, in the displaying of the prompt. 

2. The RS232-C control signals must indicate a line initialization sequence. 

• The message will be inhibited if the state of the RS232-C interface control 
leads suggests that the terminal interface has not completed a successful 
link. 

The following interface control leads are expected to be active prior to the 
transmission of any data from the IBM 7171 : 

DSR Data Set Ready (Pin #6) 

CTS Clear To Send (Pin #5) 

RLSD Received Line Signal Detector (Pin #8) 

Refer to the IBM 71 71 ASCII Device Attachment Control Unit Description 
and Planning Guide (Appendix B) for specifics regarding recommended 
cable wiring. 

If the terminal is attached through a modem (leased or switched), the 
modem must correctly condition all of the monitored leads. For Direct 
Connect configurations, DSR and CTS are driven by the cable jumpering, 
and RLSD is driven by RTS from the attached device. 



8-6 IBM 7171 Reference Manual and Programming Guide 



3. The IBM 7171 may need to be enabled for 'host communication' 

• Confirm that the 'Online/Offline' is in the 'Online' position. 

4. Confirm that 'Autobaud' has been satisfied. 

• Refer to section F-3 to determine if the problem is unique to 'Autobaud'. 

F-6: Specific range of ports can't communicate with IBM 7171. 

Note: In this section the procedure addresses the 'local' communication link, between 
the attached device, and the IBM 71 71. Reference section F-5 for an under- 
standing of the local link being considered here. 

• Are the devices failing to operate all related to ports associated with a particular 
TC Card (see Figure 8-2 on page 8-9)? 

1. Turn the power OFF at the 7 17 1 unit and reseat the TC Card that is 
suspect. Turn the power back ON at the 7171 and verify that the problem 
has been corrected. 

2. Turn the power off at the 7171, obtain a replacement TC Card and replace 
the suspect TC Card. Turn the power back ON at the 7171 and verify that 
the problem has been eliminated. 

• Is the problem associated with all devices associated with port 16 and higher? 

1 . Turn the Power Switch OFF. 

2. Remove the TC Cards TCO, TC 1 , and TC2. 

3. Reseat the two crossover cables located in the rear of the Card Container. 

4. Reinstall the TC Cards. Be certain that they are seated firmly. 

5. Turn the Power Switch to ON. 

• Is the problem associated with all devices associated with port 32 and higher? 
1. Reference section C-l, of this chapter. (Sysgen) 

• Do all of the ports fail to respond? 

1 . Turn the power OFF at the 7 1 7 1 unit and reseat the CPU Card. Turn the 
power back ON at the 7171 and verify that the problem has been cor- 
rected. 

2. If not, turn the power off at the 7171 and replace the CPU card. Turn the 
power back ON at the 7171 and verify the problem has been eliminated. 

3. Be sure to restore any customer defined Terminal Definition Tables. 
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I IBM 7171 Physical Layout 



Figure 8-1 is an illustration of the front of the 7171. Familiarize yourself with the 
locations of the following key items: 

1 . On Line/Off Line Switch 

2. Power On Indicator 

3. Ready Indicator 

4. Main Power On/Off (I/O) Switch 

5. Castor Locking Device. 

6. EMC Pads. 




Figure 8-1. Illustration of the Front of the 7171 
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RS-232-C port numbering 



The RS-232-C ports are referenced in two ways. The first is the octal numbering 
indicated on the IBM 7171 Panel Assembly units (Refer to Figure 8-2). These 
numbers correspond to RS-232-C Panel Assembly units zero through seven and to 
ports zero through seven on each Terminal Controller Card. 

The second is the system decimal numbering of the RS-232-C ports sequentially 
from zero to 63. The table in Figure 8-2 converts the octal numbering on the back 
of the IBM 7171 RS-232-C Panel Assembly units to the system sequential decimal 
port numbering. The hexadecimal equivalent of the decimal number is also 
included. 



Back 


of 


Sequential 


Back 


of 


Sequential 


Unit 




Number 


Unit 




Number 


TC# Port# 


Dec 


Hex 


TC# Port# 


Dec 


Hex 














4 





32 


20 





1 


1 


1 


4 


1 


33 


21 





2 


2 


2 


4 


2 


34 


22 





3 


3 


3 


4 


3 


35 


23 





4 


4 


4 


4 


4 


36 


24 





5 


5 


5 


4 


5 


37 


25 





6 


6 


6 


4 


6 


38 


26 





7 


7 


7 


4 


7 


39 


27 







8 


8 


5 





40 


28 




1 


9 


9 


5 


1 


41 


29 




2 


10 


A 


5 


2 


42 


2A 




3 


11 


B 


5 


3 


43 


2B 




4 


12 


C 


5 


4 


44 


2C 




5 


13 


D 


5 


5 


45 


2D 




6 


14 


E 


5 


6 


46 


2E 




7 


15 


F 


5 


7 


47 


2F 


2 





16 


10 


6 





48 


30 


2 


1 


17 


11 


6 


1 


49 


31 


2 


2 


18 


12 


6 


2 


50 


32 


2 


3 


19 


13 


6 


3 


51 


33 


2 


4 


20 


14 


6 


4 


52 


34 


2 


5 


21 


15 


6 


5 


53 


35 


2 


6 


22 


16 


6 


6 


54 


36 


2 


7 


23 


17 


6 


7 


55 


37 


3 





24 


18 


7 





56 


38 


3 


1 


25 


19 


7 


1 


57 


39 


3 


2 


26 


1A 


7 


2 


58 


3A 


3 


3 


27 


1B 


7 


3 


59 


3B 


3 


4 


28 


1C 


7 


4 


60 


3C 


3 


5 


29 


1D 


7 


5 


61 


3D 


3 


6 


30 


1E 


7 


6 


62 


3E 


3 


7 


31 


1F 


7 


7 


63 


3F 



Figure 8-2. RS-232-C port numbering conversion chart 
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F-7: Screen problems appear after entering the terminal type. 

• Confirm that the terminal type entered, is correct for the device being used. 
Certain terminals may require a special Terminal Definition Table to be cus- 
tomized and loaded into the IBM 7171. 



F-8: Modem Related problems (strapping/configuring) 

1. Confirm that cable wiring conforms to description in IBM 71 71 ASCII Device 
Attachment Control Unit Description and Planning Guide (Appendix B). 

2. Verify that the attached modem has the following general characteristics: 

a. Asynchronous - Start/Stop operation 

b. Full Duplex. 

3. Verify that the modems at each end of the link are configured with compatible 
options. 

• Character lengths must be equal. 

• Modulation techniques are compatible. 

• Baud rates must be equal. 

• Refer to the respective modem documentation for lists of options. 

4. Configure the modem attached to the IBM 7171 end of the link such that it 
uses the RS-232-C leads in the manner defined by the EIA RS-232-C specifi- 
cation. Avoid using options that force various leads to an 'active' or 'true' 
state. 

5. If Switched Network Modem attached: 

• Verify that the modem attached to the IBM 7171 monitor's DTR (pin # 
20) to determine if the modem should go off hook and answer the tele- 
phone. 

• Verify that DSR (pin #6) is dropped between sessions. (Minimum drop of 
200 milliseconds.) 
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F-9: Printer overruns on data from host. 



A buffer overrun can occur if pacing is disabled to the attached device, or if the 
device does not support pacing characters. (XON/XOFF) 

• Confirm the following: 

1. Verify that the pacing characters being used for the device are equal to 
those being used in the IBM 7171 for the port in question. 

2. If the device being locally attached is a write only device, it may deactivate 
either DTR or RTS to inhibit transmission when the buffer is becoming 
full. In this case refer to the alternate local attach wiring diagram in IBM 
71 71 ASCII Device Attachment Control Unit Description and Planning 
Guide (Appendix B). 
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F-10: Power Indicator does not turn on at Front Panel. 

If the 7171 is operating normally, the Power Indicator on the front cover (see 
Figure 8-1 on page 8-8 ) lights immediately and the Ready Indicator lights a few 
seconds after the Power On ( | ) Switch is activated. 

If the power indicator does not light, it is an indication that a malfunction exists in 
the 7171. If the ready indicator lights, it may mean that the power on indicator 
light is defective and that the 7171 is operational. If the power on light and/or 
card indicator lights, turn on for only an instant, proceed to Step 5 below. If 
neither light is on, proceed as follows: 

1 . With the ON-LINE/OFF-LINE switch to OFF-LINE, turn the Power Switch 
OFF (O), wait for at least 20 seconds and turn the Power Switch ON ( | ). 

2. With the Power Switch ON, determine by inspection whether or not the two 
fans located behind the power supply are running. If you cannot hear them, 
you may have to remove the air deflector plate above the power supply by 
taking out the two thumb screws that secure it to the power supply. MAKE 
SURE THAT THE POWER IS OFF UNTIL AFTER YOU HAVE 
REMOVED THE AIR DEFLECTOR. You can now observe the fans while 
you are turning power on. If one fan does not turn, replace it with POWER 
OFF. 

3. If the fans do not turn, turn the Power Switch OFF (O) and check that the 
7171 power cable is plugged into an active outlet. If so, check that the power 
cable inside the 7171 is plugged into the junction box located beside the fans 
and that the power supply is also plugged into the same box. 

4. Replace the power supply and turn the Power Switch ON ( | ) to verify correct 
operation. If the spare power supply has two metallic shipping plates held in 
place with thumb screws on the under side, remove them before installing the 
supply. 

5. If the power light and/or the card indicator lights turn on for only a short time 
when power is turned on, it is an indication that there may be a short some- 
where in the 7171. 

a. Turn the Power Switch OFF (O), unplug any half of the cards and turn the 
Power Switch ON (|). 

b. If the problem persists, turn the Power Switch OFF (O), unplug the other 
half of the cards while reseating the first half (this assures proper power 
supply regulation) and turn the Power Switch ON ( | ). 

6. If the power now stays on, turn the Power Switch OFF (O) and insert the 
cards one at a time, turning the Power Switch ON ( | ) after each card is 
inserted. Continue replacing one card at a time until you find the card that is 
causing the short, replace that card. 

7. If the problem still persists, replace the power supply. 

8. If you are unable to continue, invoke your Support Structure. 
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F-ll: Diagnostic failure at power-up. (When Ready Indicator Does Not Light) 

If the Ready Indicator does not light, it is an indication that an error has been 
detected by the 7171 internal diagnostics. In most instances, the failure can be 
found by using PDP detailed below. 

LEAVE THE POWER SWITCH (see Figure 8-1 on page 8-8) ON( | ). POSI- 
TION THE ON-LINE/OFF-LINE SWITCH TO OFF-LINE. 

1. If the Power indicator also did not light, see the section "PDP When Power 
Indicator Does Not Light." 

2. Open the front door of the 7 1 7 1 . 

3. Examine the individual cards in the Card Container and familiarize yourself 
with the location of the RED indicators on the individual cards. Refer to 
Figure 8-3. 

Note that each card has an alphabetic group of letters marked on the surface of 
the part that cams the card into its slot position. A corresponding alphabetic 
group of letters are marked on the surface of the Card Container immediately 
above each card slot location (see Figure 8-3). 

4. Match the card light patterns with the failing conditions patterns shown in 
Figure 8-4. Turn the Power Switch OFF (O). Remove the cards and replace 
as instructed. Insert the replacement card into the slot location of the removed 
card and seat firmly, using the card locking device. AVOID EXCESSIVE 
FORCE! 

Note: If the failing condition (light pattern) does not match the failing condi- 
tions described in Figure 8-4, invoke your Support Structure. 

5. Mark each card for identification, masking tape and a marking pen may be 
used. This is important to eliminate future mix ups with good cards. 

6. The card will contain an identifying part number on a label on the component 
side. Obtain a replacement card with an equivalent part number. 

7. Close the 7 17 1 front door and turn the Power Switch ON ( | ). 

8. The Ready Indicator should now light. 

a. If it does, skip to the step below for the ON-LINE/OFF-LINE switch. 

b. If it does not, continue. 

9. Turn the Power Switch OFF (O) and remove and reinsert each card. 

Note: Avoid excessive force on the card! Each card type has a unique con- 
nector pattern that will not allow it to be inserted into the wrong card slot posi- 
tion or in the wrong orientation. 

10. Activate the power switch to the ON ( | ) position. 
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11. Does the Ready Indicator light? 

a. If the Ready Indicator lights, the problem is corrected. Go to the 
ON-LINE/OFF-LINE step below. 

b. If not, invoke your Support Structure. 

12. Activate the ON-LINE/OFF-LINE switch to the ON-LINE position. 

13. The Ready Light should remain on. If the Ready Light goes out and all of the 
card indicator lights are on, the 7171 is not communicating with the Host 
System properly. 

a. Verify that the Host end of the cables are attached correctly. 

b. Inspect the channel cables and connectors for damaged or missing pins. 

c. If the problem persists invoke your Support Structure. 

14. Activate the Power On switch to the OFF(O) position. 

15. PDP is completed, proceed with normal operation. 
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M-5V 
"GND 

GND 
*+12V ■= 



Figure 8-3. Card Identification, Error Lights, and Voltage Test Points 

1 . Card camming device 

2. Error indicator lights 

3. Voltage test points 
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Failing Condition #1 






Card Indicator 
Location 


Card Identification 




CC 


CPU 


TC (ANY) 


Top 


On 


Off 


Off 


Middle 


On 




Off 


Bottom 


On 








1 . Turn power OFF 

2. Replace the CC Card from spare parts. 

3. Turn power ON to verify if the READY Indicator Turns ON. 

Failing Condition #2 






Card Indicator 
Location 


Card Identification 




CC 


CPU 


TC (ANY) 


Top 


Off 


On 


Off 


Middle 


On 




On 


Bottom 


Off 








1. Turn power OFF. 

2. Replace the CPU Card from spare parts. 

Be sure to have the customer replace any customer defined 
Terminal Definition Tables. 

3. Turn power ON to verify if the READY Indicator Turns ON. 





Figure 8-4 (Part 1 of 5). IBM 7171 Card Replacement Indicator Patterns 
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Failing Condition #3 



Card Indicator 
Location 


Card Identification 


CC 


CPU 


TC (ANY) 


Top 


Off 


Off 


On 


Middle 


Off 




On 


Bottom 


Off 







1 . Turn power OFF. 

2. Replace the TC Card from spare parts. 

3. Turn power ON to verify if the READY Indicator Turns ON. 

Note: If a replacement TC Card is not available, remove the 
defective card. The 7171 will function correctly except for the 
terminals that are attached to the missing card position. 



Failing Condition #4 



Card Indicator 
Location 


Card Identification 


CC 


CPU 


TC (ANY) 


Top 


Off 


Off 


Off 


Middle 


On 




Off 


Bottom 


Off 







1 . Turn power OFF. 

2. Replace the CPU Card from spare parts. 

Be sure to have the customer replace any customer defined 
Terminal Definition Tables. 

3. Turn power ON to verify if the READY Indicator turns ON. 

4. If not, remove the CPU Card from the Card Container, put it 
back in the spare parts location, plug the original CPU Card into 
the Card Container. 

5. Replace the CC Card from spare parts. 

6. Turn power ON to verify if the READY Indicator turns ON. 



Figure 8-4 (Part 2 of 5). IBM 7171 Card Replacement Indicator Patterns 
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Failing Condition #5 



Card Indicator 
Location 


Card Identification 


CC 


CPU 


TC (ANY) 


Top 


Off 


Off 


Off 


Middle 


Off 




Off 


Bottom 


On 







1. 

2. 

3. 
4. 



Turn power OFF. 

Replace the CA Card from spare parts. 

Be sure to set the channel addresses as described in Appendix A. 

Turn power ON to verify if the READY Indicator Turns ON. 

If not, remove the CA Card from the Card Container, put it 

back in the spare parts location, plug the original CA Card into 

the Card Container. 

Replace the CC Card from spare parts. 

Turn power ON to verify if the READY Indicator Turns On. 



Figure 8-4 (Part 3 of 5). IBM 7171 Card Replacement Indicator Patterns 
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Failing Condition #6 



Card Indicator 
Location 


Card Identification 


CC 


CPU 


TC (ANY) 


Top 


Off 


Off 


Off 


Middle 


Off 




On 


Bottom 


Off 







1. Turn power OFF. 

2. Replace the CPU Card from spare parts. 

Be sure to have the customer replace any customer defined 
Terminal Definition Tables. 

3. Turn power ON to verify if the READY Indicator Turns ON. 

4. If not, remove the CPU Card from the Card Container, put it 
back in the spare parts location, plug the original CPU Card into 
the Card Container. 

5. Replace the TC Card from spare parts. 

6. Turn power ON to verify if the READY Indicator Turns On. 

Note: If a replacement TC Card is not available, remove the defective 
card. The 7171 will function correctly except for the terminals that 
are attached to the missing card position. 



Failing Condition #7 



Card Indicator 
Location 


Card Identification 


CC 


CPU 


TC (ALL) 


Top 


Off 


Off 


Off 


Middle 


On 




On 


Bottom 


Off 







1. Replace the CPU Card. 

Be sure to have the customer replace any customer defined 
Terminal Definition Tables. 

2. Turn power ON to verify if the READY Indicator Turns ON. 



Figure 8-4 (Part 4 of 5). IBM 7171 Card Replacement Indicator Patterns 
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Failing Condition #8 



Card Indicator 
Location 


Card Identification 


CC 


CPU 


TC (ALL) 


Top 


On 


On 


On 


Middle 


On 




On 


Bottom 


On 







1 . Verify that the 7 17 1 and Host ends of the channel cables are 
attached correctly. 

2. Inspect the channel cables and connectors for damaged or missing 
pins. 

3. If the problem persists invoke your Support Structure. 



Figure 8-4 (Part 5 of 5). IBM 7171 Card Replacement Indicator Patterns 

For any other failing patterns, record the pattern and invoke your Support Struc- 
ture. 
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F-12: Intermittent Power or Diagnostic failures. 

Intermittent problems in the 7171 can occur for a number of reasons. The most 
common causes are: 

• Insufficient cooling 

• Loose cable connectors 

• Loose circuit cards 

• Marginal power supply. 

The following steps are suggested to help solve intermittent system errors in opera- 
tion that can be attributed to the 7171 unit. 

Turn the ONLINE/OFFLINE switch to the OFFLINE position when performing 
any of the following steps. Refer to Figure 8-1. 

Stepl 

1 . Turn the Power Switch OFF(O). 

2. Remove the Fan Deflector Cover Fasteners and Plate. 

3 . Turn the Power Switch ON( | ) . 

4. Verify that the fan(s) are turning. 

5. If the fans are turning proceed to step 2. 

6. If the fan(s) are not turning, turn the Power Switch OFF(O). 

7. Remove and reinsert the fan connectors in the rear of the power supply. 

8. Turn the Power Switch ON( | ). 

9. Verify that the fan(s) are turning. 

10. If the fan(s) are not turning, turn the Power Switch OFF(O). 

11. Obtain replacement fan(s) and replace the defective fan(s) with new fan(s). 
Mark the defective parts to identify its status. 

12. Turn the Power Switch ON( | ). 

13. Verify that the fan(s) are turning. 

14. If the fan(s) are not turning, proceed to step 4. 

15. If the fans are turning, turn the Power Switch OFF(O). 

16. Replace the Fan Deflector Cover Fasteners and Plate. 

17. Turn the Power Switch ON( | ). 
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18. Return 7171 to normal operation by turning the ONLINE/OFFLINE switch to 
ONLINE. 

Step 2 

If a common problem is experienced with all ASCII devices associated with ports 
16 or higher: 

1 . Turn the Power Switch OFF(O) . 

2. Remove the TC Cards TCO, TCI, and TC2. 

3. Reseat the two crossover cables located in the rear of the Card Container. 

4. Replace the TC Cards. Be certain that they are seated firmly. 

5. Turn the Power Switch to ON( | ). 

6. Verify that the intermittent problem is resolved. 

7. If problem is not resolved continue with step 3. 

8. If problem is resolved return 7171 to normal operation by turning the 
ONLINE/OFFLINE switch to ONLINE. 

Step 3 

1 . Turn the Power Switch OFF(O) . 

2. Reseat each circuit card, in the Card Container, one at a time. 

3. Turn the Power Switch to ON( | ). 

4. Verify that the intermittent problem is resolved. 

5. If problem is not resolved continue with step 4. 

6. If problem is resolved return 7171 to normal operation by turning the 
ONLINE/OFFLINE switch to ONLINE. 

Step 4 

There are presently two methods available to servicing personnel that may be uti- 
lized to determine if the 7171 power supply is a potential cause of 7171 intermit- 
tent operating errors. 

Method #1 involves using a voltmeter to measure the dc output voltage levels of the 
power supply to determine if it is operational, and if the output voltage levels that it 
is supplying are within an operational tolerance range. 

Method #2 will be used if a voltmeter is not available. 
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Implementing Method #1 

CAUTION 

This test will be conducted with the Power Switch ON( | ). Please 
remove all jewelry from your hands and arms when performing this test. 

ATTENTION The dc voltmeter used to measure the voltages should have an 
internal movement resistance of at least 20,000 ohms/volt to prevent damage to 
the 7171 and to provide an accurate voltage level reading. 

Open the 7171 front cover and observe the visible end of any inserted TC card. 

Located on the upper and lower portion of the visible TC card end are two pairs of 
plastic coated voltage probe test points. From the top of the card to the bottom of 
the card they are labeled TP1, TP2 and TP3, TP4. TP1 connects to +5 volts, TP2 
to ground, TP3 to +12 volts, and TP4 connects to -12 volts. 

Set your voltmeter to the proper scale, select the proper polarity for the voltmeter 
probe points and proceed to measure the respective voltages. 

If the power supply voltage measure outside of the voltage tolerance range, proceed 
with Method #2. 

Acceptable Power Supply Voltage Level Tolerance Range 

1. +5 volts +4.75 volts to +5.25 volts 

2. +12 volts +10.8 volts to +13.2 volts 

3. -12 volts -10.8 volts to -13.2 volts 

Implementing Method #2 

CAUTION 

Turn the Power Switch OFF(O) and REMOVE THE LINE CORD 

FROM THE POWER OUTLET RECEPTACLE. 

1. Remove the fan plugs and the dc power cable from the power supply. Remove 
the power supply cord from the Line Junction Box. 

2. Remove the power supply and replace with a new one. If the new power 
supply has two metallic shipping plates held in place with thumb screws on the 
under side, remove them before installing the supply. 

3. Insert the fan cables and the dc power cable into the power supply. Insert the 
power supply cable into the Line Junction Box. 

4. Insert the Line Cord into the power outlet. 

5. Turn the Power Switch to ON( | ). 

6. Verify that the intermittent problem is resolved. 

7. If problem is not resolved, invoke your Support Structure. 
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If problem is resolved return 7171 to normal operation by turning the 
ONLINE/OFFLINE switch to ONLINE. 
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C-l: Can't VARY ONLINE or ENABLE device 

This can be due to several things. The host System Control Program (SCP) may be 
incorrectly supporting the 7171. If the SCP doesn't include the 7171 addresses as 
a 3274-1D control unit with supported device types, a new SCP will have to be 
created by doing a system generation (sysgen). 

• Reference section 2.7 'Setup requirements for the IBM 7171' 

The CA address switches may not be set up correctly. The channel adapter (CA) 
card in the 7171 has a switch that controls the base address and range of addresses 
of the 7171 on the channel. The CA card is the left most card in the 7171. It may 
be removed when the 7171 is turned off. 

• For assistance, reference the 7171 Description and Planning Guide section 
'Connection to the Host'. 

The problem could also be that no UCW is defined. 

The host is attempting to send TIOs and SIOs to a channel address which is not 
defined in the channel UCWs. The SIO will fail with a condition code of 3 
(CC=3) The host control program, either VM or MVS, will note this as 'device 
unavailable'. 

The UCW is a part of the channel architecture. They define what address ranges 
are supported by the channel. 

• If a UCW redefinition is required. Reference the 7171 Description and Plan- 
ning Guide section 'Connection to the Host' for assistance. 

C-2: Cursor to bottom right after ENTER TERMINAL TYPE 

The host System Control Program (SCP) may be incorrectly supporting the 7171. 
If the SCP doesn't include the 7171 addresses as a 3274-1D control unit with sup- 
ported device types, a new SCP will have to be created by doing a system gener- 
ation (sysgen). 

• Reference section 2.7 'Setup requirements for the IBM 7171' 

The CA address switches may not be set up correctly. The channel adapter (CA) 
card in the 7171 has a switch that controls the base address and range of addresses 
of the 7171 on the channel. The CA card is the left most card in the 7171. It may 
be removed when the 7171 is turned off. 

• For assistance, reference the 7171 Description and Planning Guide section 
'Connection to the Host'. 

Possibly the host computer is not running. It could be because it is not powered up 
or not IPLed, or not responding due to an ABEND condition. An active SCP must 
be in the host. Both MVS and VM are supported. 

• Get assistance from your system programmer or contact IBM for assistance. 
Possibly the device address is not active. 
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This devices' address may not be enabled at the host. Inbound interrupts will be 
swallowed by the host without any response. 

• Enable the device address. 

Possibly the channel cables are incorrectly hooked up, faulty, or not attached. 

If no channel cables are attached to the 7171, it will not ready after powering up. 
There is a READY light on the front of the box to check if this is the case. 

• Test the channel cables to see if they are faulty. 

C-3: Interface Control Check, 'GOT STATUS OF WRONG DEVICE...' 

This is a user error in the UCW definitions of the channel. This 48/64 port 7171 
has a single UCW defined instead of one for each 32 ports. The 7171 is pro- 
grammed to treat each 32 port group independently. It may present status asyn- 
chronously on one subchannel while within a CCW chain on the other subchannel. 
This is justification for an Interface Control Check in a single UCW environment. 

• A UCW redefinition is required. Reference the 7171 Description and Planning 
Guide section 'Connection to the Host' for assistance. 

C-4: 1\1\ locks up on first readying terminal with first write command 

The channel UCW definition for the 7171 addresses is Selector, or BMPX with the 
Selector option. Selector channels remain dedicated to the control unit from initial 
status to ending status for a command. A BMPX channel is dedicated from initial 
status till channel end status. Then device end status is presented asynchronously. 
The 7171 is internally programmed to always work with a BMPX channel. The 
7171 will lock a selector channel when it attempts to present status asynchro- 
nously. 

• Redefine the UCW to be a Blocked Multiplexor without the Selector option. If 
assistance is required, reference 8.1.1, "Assistance for Problem 
Determination." 

C-5: READY drops when 7171 switched online 

The channel cables are incorrectly hooked up, faulty, or not attached. 

If no channel cables are attached to the 7171, it will not ready after powering up. 
There is a READY light on the front of the box to check if this is the case. 

• Test the channel cables to see if they are faulty. 

C-6: Operational checks for a 7171 device 

The Operating System (SCP) sysgen is incorrect. An invalid device type exists in 
the 7171 portion of the host sysgen definition. The address associated with the 
error message is the device type in error in the sysgen. 

Either the SCP sysgen should be redone, or that 7171 address should not be used. 
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Reference section 2.7 'Setup requirements for the IBM 7171' for the supported 
devices and assistance in doing a sysgen. 
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Chapter 9. Special Maintenance Facility and System Messages 



9.1 Brief Overview 



The special Maintenance Facility allows added control of the IBM 7171. This 
facility provides visibility into the IBM 7171, as well as a level of control over the 
operating environment. Entry to this facility is available only to the terminal 
attached to port of Terminal Controller (TC) 0. When functioning in this facility 
the attached terminal is referred to as the "operator console" and the person using 
that terminal as the "console operator." 

The console operator has the ability to examine and store data into the IBM 7171 
memory. All IBM 7171 error messages are logged and reported to the operator 
console. The Maintenance Facility can be used for debugging as well as moni- 
toring functions. 

This facility allows the user to maintain both his host session, and his operator 
console session concurrently. In addition he may toggle back and forth between his 
host session screen and the operator console screen. Information is not lost on 
either session. 

It is also possible to enter terminal tables, and other information into NV-RAM 
through this facility. The data is entered via the store command. For a complete 
description of the data in NV-RAM, refer to Chapter 4, "Customizing IBM 7171 
Tables" of this document. 



9.2 How to Invoke the Maintenance Facility 



This facility can only be accessed through the terminal plugged into port of TC 0, 
and is password protected. When the terminal is connected to the IBM 7171, the 
message: 

ENTER TERMINAL TYPE: 

appears. To enter this facility, enter the maintenance password, which is initially 
set to: 

OPERATOR 

The IBM 7171 then responds again with the same message: 

ENTER TERMINAL TYPE: 
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Now key in the terminal type being used. The host session logo should now 
appear. To invoke the Maintenance Facility press Ctrl-W on the keyboard. The 
screen should now go blank. The Maintenance Facility is now active and com- 
mands may be typed in. To toggle back to the normal host session screen, press 
Ctrl-W. 

If an internal IBM 7171 error occurs during a host session the screen will be auto- 
matically toggled to operator console mode and a message describing the error that 
occurred will be displayed. To return to the host session screen, simply press 
Ctrl-W again. 

Note: Although the same terminal may be toggled between operator console 
screens and host session screens, host sessions that use the host/7171 transparency 
mode should not be used since unexpected results may occur. 

Note: The Ctrl-W character is defined in the reset character sequence for each ter- 
minal. It is possible to redefine the sequence that initiates the Maintenance Facility 
toggle. For details refer to 4.4.4, "TDT Area Layout" on page 4-25. 



9.3 How to Use Maintenance Facility 



This facility provides a fullscreen user interface. All normal IBM 7171 keyboard 
commands are still legal for the operator console. Each line on the screen is defined 
as a field. Forward field tabs, backward field tabs, insert, delete etc. are all valid. If 
a command is typed incorrectly, the cursor can be repositioned to the line on which 
the error occurred, and the mistake can be corrected. This facility interprets what- 
ever is on the line the cursor is on at the time ENTER is pressed. Characters that 
are past the end of the command are ignored. One command may not exceed one 
line in length. 

Spacing is critical to all commands. Typically, each command is one or two letters 
in length, followed by a space. There should be a space between each argument as 
well. All addresses are given as: 

seg-.of f s 

Where: 

seg 

and 

offs 

are hex numbers. Legal characters for hex digits are 0-9 and A-F, no distinction is 
made between upper and lower case. 

All input precision is limited to 16 bits. Any hex input larger than X ' FFFF ' , or 
any decimal input larger than 65,535 will generate an error. 
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Warning: This facility is a very powerful debugging tool, however, 
since it is so powerful it should be used with extreme caution. When 
executing the store command, the user is changing IBM 7171 memory 
and must be extremely careful. Further, the memory-mapped I/O 
area will be affected simply by READING. For this reason, DO 
NOT DISPLAY memory mapped I/O. This area is from address 
X ' 84000 ' to X ' 8428 C ' . Unpredictable results will occur if the user 
tries to display this area. 



9.4 Maintenance Facility Error Handling 



The IBM 7171 has a system to keep track of internal system errors as they occur. 
The control of the error facility is governed by the user at the operator console. 
The errors are recorded in Non- Volatile RAM (NV-RAM) and remain in memory. 
If errors occur and this facility has not been activated using the Maintenance 
Facility password, they are still logged. These messages will be displayed on the 
operator console as soon as the Maintenance Facility becomes active. Errors are 
reported directly to the operator console if the Maintenance Facility is active, but if 
the normal host session is selected at the time, the terminal is switched directly to 
operator console mode and the error message is displayed. 

The error messages are kept in a circular list, and are numbered starting from to 
11. The errors are recorded sequentially as they appear, and are kept in memory 
until written over by another error message. Thus, after error message number 1 1 is 
logged, the next error message will overwrite message 0. 



9.5 How to Change the Password and Parse Tables 



The Maintenance Facility gives the user a great deal of control over the IBM 7171. 
It is password protected. The Maintenance Facility password is stored in 
NV-RAM and is retained while the IBM 7171 is powered down. This password is 
referred to as the Maintenance password, and is initially set to 'OPERATOR'. 

The interface for an automated table generating program is also password pro- 
tected. The password for this interface is known as the ZAP password, and is ini- 
tially set to '@@ZAP@@'. The provided IBM 7171 Support Utility described in 
Appendix C, "IBM 7171 Support Utility for Modifying Terminal Tables" commu- 
nicates to the IBM 7171 via the ZAP interface, see Appendix D, "Interface for 
User Supplied Table Modification Program" on page D-l for a description of the 
ZAP interface. 
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The password changing function of the Maintenance Facility allows the password 
to be changed easily. The user is strongly advised to change both of these pass- 
words as soon as the system is installed and as often as necessary to maintain the 
integrity of the system. 

Note: The Maintenance Facility password should always be different than the 
ZAP interface password. Each function is mutually exclusive in function. Each of 
these functions require a unique password. 

Note: Whenever NV-RAM is rewritten, or new NV-RAM is installed, the pass- 
words will revert to their initial settings and should be reset to the installation 
choice as soon as possible. 
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9.6 Console Operator Commands 



The following pages contain a description of each of the console operator com- 
mands. They are: 

A Display Data Control Block (AC2) 

C Configure Ports 

CM Display CC Board Memory 

CO Copy data block 

CS Store to CC Board Memory 

D Date 

E Error Message Display 

FC Force Unsolicited Device End 

FD Force Terminal to Drop Line 

FT Force Terminal to 'ENTER TERMINAL TYPE' message 

H Help 

I Inword 

M Display CPU Board Memory 

MW Display one Word of CPU Board Memory 

N Send Notes to Terminals 

O Outword 

P Port Configuration 

PW Password Change 

S Store to CPU Board Memory 

SW Store one Word to CPU Board Memory 

T Terminal Characteristic Display 

TM Display Terminal Controller (TC) Board Memory 

TS Store to Terminal Controller (TC) Board Memory 

X Toggle default character output (ASCII/EBCDIC) 

= Perform calculator functions 
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9.7 A - Display AC2 Data Block for a Device 



Use the A command to display the AC2 block for a specific device, or AC2. 
Format: 



A 
A 


device [len] 
addr [len] 



Where: 

device Is a decimal device number in the range 0-63. 

addr Is the address of an AC2. This address is the segment value for the AC2. 
No check is done to see that the given segment is indeed an AC2. 

len Is an optional length, in bytes, to be displayed. If this argument is 

omitted, 80 bytes is the default length. 

Example: 

a 56 
a 36c 

Both of these commands might result in the following response: 



036C:0000 C234 5678 9ABC DEFO C234 5678 9ABC DEFO 

036C:0010 C234 5678 9ABC DEFO C234 5678 9ABC DEFO 

036C:0020 C234 5678 9ABC DEFO C234 5678 9ABC DEFO 

036C:0030 C234 5678 9ABC DEFO C234 5678 9ABC DEFO 

036C:0040 C234 5678 9ABC DEFO C234 5678 9ABC DEFO 

036C:0050 C234 5678 9ABC DEFO C234 5678 9ABC DEFO 

036C:0060 C234 5678 9ABC DEFO C234 5678 9ABC DEFO 

036C:0070 C234 5678 9ABC DEFO C234 5678 9ABC DEFO 



IB. .. 


. . .OB. . . 


. . .01 E 


IB. . . 


. . .OB. . . 


. . .01 E 


IB. .. 


. . .OB. . . 


. . .01 E 


IB/.. 


. . .OB. . . 


. . .01 E 


IB.. . 


. . .OB. . . 


. . .01 E 


IB. .. 


. . .OB. . . 


. . .01 E 


IB. . . 


. . .OB. . . 


. . .01 E 


IB. . . 


. . .OB. .. 


. . .01 E 



The A/E to the right of the dump indicates whether the characters displayed are 
the ASCII or EBCDIC translations of the data dumped. 

Error Messages: 

Invalid device or AC2 value given. 
Device not attached. 
Invalid device number. 
Invalid Length Specification. 
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9.8 C - Configure IBM 7171 Ports 



Use the C command to configure any of the ports that are attached to the IBM 
7171. 

Format: 



c 
c 


port 

port opt [opt ...] 



Where: 

port Is a decimal device number. 

opt Is a one character option followed by an argument. The options can be 

any one of the following: 

Option Argument 

b Baud rate. The following baud rates are supported and are 

autobaud detectable: 300, 600, 1200, 1800, 2400, 3600, 4800, 
9600 and 19200 baud. If the baud rate is set to zero, then the 
terminal will default to autobaud detect mode. The following 
baud rates are supported, but not autobaud detectable: 50, 75, 
110, 134, 150, 2000, and 7200 baud. 

f Terminal Flag Word. The meanings of these flags are as 

follows: 

Byte 1 Flags 

Bits Meaning 

20 Stick bit. 

Off or = Parity bit is interpreted as Even or 

Odd 

On or 1 = Parity bit is interpreted as Mark or 

Space 
10 Parity - depends on the current setting of the Stick 
bit. 

Off or = Odd or Mark parity 

On or 1 = Even or Space parity 
08 Parity enable. 

Off or = Parity disabled 

On or 1 = Parity enabled 
04 Number of stop bits. 

Off or = 1 stop bit 

On or 1 = 2 stop bits 



Chapter 9. Special Maintenance Facility and System Messages 9-7 



02-01 Number of data bits. 

00 = 5 data bits 

01 = 6 data bits 

10 = 7 data bits 

11 = 8 data bits 

Byte 2 Flags 

Bits Meaning 

0080 Ignore high order bit of input from terminal. 
0020 Stick bit for output parity generation when high bit 
of input is ignored. 

On or 1 = High order bit is generated as Mark 

or Space parity 

Off or = High order bit is generated as Even 

or Odd parity 
0010 Parity bit for output parity generation when high bit 
of input is ignored. 

On or 1 = Even or Space parity 

Off or = Odd or Mark parity 

Note: The preceding three bits are intended to be 
used when parity is to be ignored on input. 
The port should be configured with eight data 
bits, parity disabled. 

This configuration option can be done on a 
per port basis, or at a system level. The above 
port level configuration option is only effective 

if the system level has not been specified. 

02-01 Type of connection. 

00 = Let 7171 determine type of connection 

01 = Switched Network (telephone line) 
10 = Leased Line 

11= Direct Connection 

t Terminal type to automatically assign port at line connect time. 

This is the name of a terminal whose Terminal Definition Table 
is currently stored in the IBM 7171. If this field is 0, the ter- 
minal user will be prompted with the 'ENTER TERMINAL 
TYPE' message. 

| v Terminal name whose sublist should be displayed at the 

I ' VALID TYPES ARE: ' prompt. If this field is 0, the terminal 

| user will see the Terminal Names List which begins at 

| X'DCOOiSOO'. 

If no options are present, the current status of the port is displayed. 
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Notes: 

1 . Options may appear in any order on the command line. One or all options may 
be set at once. The format is free form. However, there must be one space 
between options, and the argument must immediately follow the option. 

2. Options are processed as they are encountered. If two identical options are 
found on the same command line, the latter option is the one that will take 
effect. If an error is encountered in one option, processing is stopped. The 
options listed before the error will have been changed, the ones appearing after 
the error will not have been changed. 

3. Most changes will take effect AFTER the next line drop. The only exception 
is the Connection Type field in the flag word. These changes only take effect 
at the next IBM 7171 power up. 

Example: 

c 56 b9600 tIBM3101 f1A03 

This command configures port 56 to the following: 

1. 9600 baud. 

2. This terminal is assumed to be an IBM3 101 and the 'ENTER TERMINAL 
TYPE:' message will not be displayed. 

3. The flags set the terminal as follows: Even Parity, Parity Enabled, 1 stop bit, 7 
data bits, force to direct connect. 

Example 2: 

c 56 bO VIBM3101 tO 

This command configures port 56 to the following: 

1 . Autobaud detect, 

2. Since there is no terminal type assigned to this port, the terminal user will be 
prompted with 'ENTER TERMINAL TYPE:'. If the 'VALID TYPES ARE:' 
message is displayed by the user, it will consist of the Terminal Names sublist 
that contains the IBM3101 terminal type. 

Example 3: 

c 56 

This command requests the terminal status for port 56. A response might be: 

Dvc #56 Baud: Flags: 1A03 Terminal: 0000 TNL: IBM3101 AC2 : 0000 

This would be the response after the configure command listed above. 

Note: If Maintenance Facility cannot determine the TERMINAL TYPE from the 
information stored, the actual address will be displayed. 
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Error Messages: 

Invalid device number. 

Invalid configure option encountered. 

Bad row value given 

Bad column value given 

Bad baud rate given 

Bad flag value given 

Bad terminal type given 
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9.9 CM - Display Channel Controller (CC) Board Memory 



Use the CM command to display the channel controller (CC) board memory. Up 
to hex FF bytes of CC memory may be displayed at one time. Values may be 
entered in either upper or lower case, and leading zeros are not required. 

Format: 



CM 
CM 


seg:offs len 
seg:offs 



Where: 

seg Specifies the memory segment value, in hex. 

offs Specifies the memory offset, in hex. 

len Indicates the number of bytes to be displayed. If length is omitted, one byte 
will be displayed. If length specified is larger than hex FF, FF will be the 
default. 

\ 

/ Example: 

cm 0: 1a0 22 

This command requests a display of hex 22 bytes of CC memory starting at 
segment and offset 1A0. A response might be: 

c 0000:01A0 1234 5678 9ABC DEFO 1234 5678 9ABC DEFO I . 4Vx 4VX....I A 

c 0000:01B0 1234 5678 9ABC DEFO 1234 5678 9ABC DEFO I . 4Vx 4Vx I A 

c 0000:01C0 1234 I .4 I A 

The 'c' indicates that CC memory is being displayed. 

The A/E to the right of the dump indicates whether the characters displayed are 
the ASCII or EBCDIC translations of the data dumped. 

Error Messages: 

Invalid Segment Specification. 

Invalid Offset Specification. 

Invalid Length Specification. 

Address specified wraps addressability boundary. 
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9.10 CO - Copy Data Block 



Use the CO command to copy a block of data from a source (segment: offset) 
address to a destination (segment: offset) address. Up to hex 400 bytes can be 
copied at one time. Values may be entered in either upper or lower case, and 
leading zeros are not required. 

Format: 



CO 
CO 


sseg:soffs dseg:doffs len 
sseg:soffs dseg: doffs 



Where: 

sseg Specifies the source memory segment value, in hex. 

soffs Specifies the source memory offset, in hex. 

dseg Specifies the destination memory segment value, in hex. 

doffs Specifies the destination memory offset, in hex. 

len Indicates the number of bytes to be copied. If length is omitted, one byte 
will be copied. If length specified is larger than hex 400, hex 400 will be 
the default. 

Example: 

co dc00:4ce6 dc00:800 50 

This command copies hex 50 bytes from address starting at dc00:4ce6 (source 
segment -.offset) to address starting at dc00:800 (destination segment: offset). 

Error Messages: 

Invalid Segment Specification. 
Invalid Offset Specification. 
Invalid Length Specification. 
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9.11 CS - Store to CC Board Memory 



Use the CS command to store to CC board memory. Only one byte at a time may 
be stored to CC memory. Values may be entered in either upper or lower case, 
and leading zeros are not required. 

Format: 



CS 


seg:offs byte 



Where: 

seg Specifies the memory segment value, in hex. 
offs Specifies the memory offset, in hex. 
byte Is the one byte that you wish to store. 

Example: 

cs 0: 1a0 b3 

This command stores the value B3 in CC memory at segment and offset 1A0. 
No response is given. 

Error Messages: 

Invalid Segment Specification. 
Invalid Offset Specification. 
Invalid Storage Byte Format. 
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9.12 D - Date Commands 



Use the DATE command to set the internal IBM 7171 date constant, or to display 
the current IBM 7171 date constant. Only decimal numerals are allowed. 

Format: 



D 
D 


mm-dd-yy 



Where: 

mm Specifies the decimal month, to be no larger than 12. 

dd Specifies the day, to be no larger than 3 1 . 

yy Specifies the year, to be no larger than 99. 

The command D by itself is a request to display the current date constant D fol- 
lowed by a new date sets the internal IBM 7171 date constant to the specification 
given. 

Note: The date command is intended only to be used as a relative time stamp for 
error messages. It is not updated by the IBM 7171. The date constant is only as 
useful as the user makes it. It is not intended to be a calendar substitute. It is 
recommended that the user set the date constant as often as possible. Since error 
messages are kept in a circular list, it would be almost impossible to determine 
exactly when an error occurred if the date constant were not changed. 

Example: 

D 6-30-84 

This command sets the IBM 7171 date constant to June 30, 1984. To verify the 
date set, the Maintenance Facility will respond with: 

Current Date: 6-30-84 
Error Messages: 

Invalid Date Specification. 
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9.13 E - Display Error Message Information 



Use the E command to display error messages. All values given are in decimal. 
Values must not be larger than the maximum number of errors in the list. 

Format: 



E 




E 


ml 


E 


ml m2 



Where: 

ml Refers to the first error message to display. 

m2 Refers to the last error message to display. 

If no arguments are given, the number of the current error message is displayed. 

If only ml is specified, only that error message is displayed. 

If both ml and m2 are specified, Error messages are displayed starting at ml, and 
continuing through m2. The command "e 1 3" will display messages 1 thru 3. 
Since the list of error messages is continuous, the command "e 2 1" will display the 
entire list of error messages. 

Example: 

e 

This command requests a display of the current error number. A response might 
be: 

Current Error Message Number: 

This informs the user that the last error message written was to error message 
number 0. 

e 

This is a request to display error message number 0. A response might be: 

Msg #0 Date: 6-30-84 Dvc # 63 Parameters P0,P1,P2: 0034 F502 1234 
Received Unsolicited DMA. 

Where: 

Msg # Indicates which position in the error message list is being displayed. 
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Date: Indicates the IBM 7171 date constant on which the error message 

was logged. 

Device # Indicates which device number, in decimal, logged the error. 

Parameters List three parameters that were saved at the time of the error. Refer 
to the section 9.31, "System Error Messages" for the meaning of the 
parameters. 

Message Is the description of the error that occurred. 

Error Messages: 

Invalid Error Numbers Given. 

Error Numbers Given Are Out Of Range. 
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I 9.14 FC - Force Unsolicited Device End 



Use the FC command to cause the IBM 7171 to send an unsolicited Device End to 
devices enabled by the CA card switch settings. 

Format: 



FC 
FC 


port 
A 



Where: 

port is a decimal device number 

A Specifies all enabled device addresses should receive a Device End. 

Example: 

fc 5 

This command will send an unsolicited Device End to port 5. 
Error Messages: 

Invalid Device Number. 



Chapter 9. Special Maintenance Facility and System Messages 9-17 



9.15 FD/FT - Force a Device Offline. 



Use the FD command to drop a terminal's line. Use the FT command to force a 
terminal back to the ENTER TERMINAL TYPE message. 

Format: 



FD 
FT 


dev 
dev 



Where: 

dev Specifies the device number to be forced, in decimal. Only device numbers 
from to 63 are legal. 

The FT command will force the terminal back to the 'ENTER TERMINAL TYPE' 
message. However, the line will remain connected. The FD command will drop 
the connection between the terminal and the IBM 7171. In both cases, a line dis- 
connect is sent to the host. 

Example: 

ft 56 

This command will force the device attached to port 56 back to the 'ENTER TER- 
MINAL TYPE' message. To determine device number, see the PORT command. 

Error Messages: 

Invalid Device Number. 
Device Not Attached. 
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9.16 H - Help Command 



Use the H command to display a list of all valid commands. 
Format: 



H 





Example: 

h 

The help response is: 

VALID COMMANDS ARE: 

Ac2 display, Cc Memory, Cc Store, Configure ports, COpy data block, Date, 
Error display, Force Terminal message, Force Drop line, Help, Inword, 
Memory display, Memory Word, Note, Outword, display Port status, Store byte, 
Store Word, Terminal data display, Tc Memory display, Tc Store byte, 
Xchange ASCII/EBCDIC, = calculate 

The command abbreviation is found in uppercase. 
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9.17 I - Inword Command 



Use the I command to display a word from the specified I/O port. The port value 
is specified in hex. The port may be entered in either upper or lower case, and 
leading zeros are not required. 

Format: 



I 


port 



Where: 

port Specifies the I/O port to be read. The port number is specified in hex, and 
the response is in hex. 

Example: 

I ffcO 

This command requests a read of I/O port FFCO. A response might be: 

0120 

Error Messages: 

Invalid I/O Port Number Specification. 
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9.18 M - Display CPU Board Memory 



Use the M command to display CPU board memory. Up to hex 150 bytes of CPU 
memory may be displayed at one time. Values may be entered in either upper or 
lower case, and leading zeros are not required. 

Format: 



M 

M 


seg:offs len 
seg:offs 



Where: 

seg Specifies the memory segment value, in hex. 

offs Specifies the memory offset, in hex. 

len Indicates the number of bytes (in hex) to be displayed. If length is omitted, 
one byte will be displayed. If the length specified is larger than hex 150, 
150 will be the default. 

Example: 

m dc00:0 25 

This command requests a display of hex 25 bytes of CPU memory starting at 
segment DC00 and offset 0. A response might be: 



DC00 


0000 


1234 


5678 


9ABC DEF0 1234 5678 9ABC DEF0 


I . 4Vx . . . 


. . 4Vx . . . 


. I A 


DC00 


0010 


1234 


5678 


9ABC DEF0 1234 5678 9ABC DEF0 


I . 4Vx . . . 


. . 4Vx . . . 


. I A 


DC00 


0020 


4142 


4344 


45 


I ABCDE 




I A 



The A/E to the right of the dump indicates whether the characters displayed are 
the ASCII or EBCDIC translations of the data dumped. 

Error Messages: 

Invalid Segment Specification. 

Invalid Offset Specification. 

Invalid Length Specification. 

Address specified wraps addressability boundary. 
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9.19 MW - Display One Word of CPU Board Memory 



Use the MW command to display one word of CPU board memory. Only one 
word may be displayed at a time. Values may be entered in either upper or lower 
case, and leading zeros are not required. 

Format: 



MW 


segroffs 



Where: 

seg Specifies the memory segment value, in hex. 
offs Specifies the memory offset, in hex. 

Example: 

mw dc00:0 

This command displays the word that is in CPU memory at the given location. A 
response might be: 

w DC00:0000 0120 

The 'w' indicates that the display is of a Word, and not 2 Bytes. The word is not 
byte reversed as it is displayed. 

Error Messages: 

Invalid Segment Specification. 
Invalid Offset Specification. 
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9.20 N - Send Notes to Attached Terminals 



Use the N command to display notes on all or one attached terminal. 
Format: 



N 
N 


amsg 
device msg 



Where: 

a Is the letter 'A'. This dispatches notes to all attached terminals 

device Is the decimal device number of one terminal to receive the message 
msg Is a message up to 70 characters long 
Notes: 

1. After receiving the note the terminal user must key in the MASTER RESET 
sequence (usually a control-G) to return to his host session. 

2. Only the first 70 characters of the message following the command will be sent 
to the devices. Long messages must be sent via several NOTE commands. 

3. When notes are sent to all terminals, output is suppressed on hardcopy devices 
and devices operating in the IBM 7171 transparency mode. Sending a note to 
a device that is operating in IBM 7171 transparency mode generates an error. 
Sending a note to a specific device that is in hardcopy mode is allowed. 

Example: 

n a This is a note to all terminals. 

This command sends the above message to all terminals attached to the IBM 7171 
at the time the command was issued. 

Error Messages: 

Invalid Device Number. 
Device Not Attached. 
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9.21 O - Outword Command 



Use the O command to write a word to the specified I/O port. The port value and 
word are specified in hex. The values may be entered in either upper or lower case, 
and leading zeros are not required. 

Format: 



o 


port val 



Where: 

port Specifies the I/O port to be written to. The port number is specified in 
hex, and the response is in hex. 

val Specifies the value to be written, given in hex. 

Example: 

ffcO 1234 

This command writes the hex value 1234 to I/O port FFCO. 

Error Messages: 

Invalid I/O Port Number Specification. 
Invalid Output Data Given. 
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9.22 P - Display Port Configuration 



Use the P command to display the IBM 7171 current port configuration. 
Format: 




Where: 

tc Indicates a request to display the port configuration of a specific TC. 

Example: 

P 

This command requests a display of the IBM 7171 port configuration. A response 
might be: 

tc 0-036C IBM3101 1 -Unattached 2-046B HARDCOPY 3-Unattached 

\ tc 4-04AA IBM3101 5-Unattached 6-Unattached 7-Unattached 

J tc 1 8-Unattached 9-Unattached 10-Unattached 1 1 -Unattached 

tc 1 12-059D IBM3101 1 3-Unattached 14-Unattached 1 5-Unattached 

The TC on which the ports exist is listed at the start of the line. For each port 
there is the following information: dvc,addr,type 

dvc Is the device number of that port. This is a decimal value, and is to be used 
for all other device specific commands, such as Configure, Force, and Note. 

addr Indicates the segment address of this port's data control block. 

type Indicates what type of terminal, if known, is attached to this port. 

Notes: 

1 . If the terminal is at the 'ENTER TERMINAL TYPE' message, and is not yet 
initialized, this field will be left blank. 

2. Any port listed as UNATTACHED indicates that either nothing is plugged into 
that port, or the terminal is powered off. 

3. If the terminal type was predefined for a specific port but the terminal type can 
not be determined from the address specified, the word INVALID will be dis- 
played. 
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4. Any invalid characters that are typed in response to the ENTER TERMINAL 
TYPE message will be displayed in this field. This is to aid in locating certain 
terminals. For instance, if a unique character sequence was typed in response 
to the ENTER TERMINAL TYPE message, such as "xxxxx," the "xxxxx" 
would show up in the Ports response, and the device number of the terminal in 
question could be identified. 

Error Messages: 

Invalid TC board specified. 
TC not inserted. 
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9.23 PW - Change Maintenance Passwords 



Use the PW command to change the IBM 7171 Maintenance Facility passwords. 
Format: 



PW 
PW 


o password 
z password 



Where: 

o Indicates that this request is to change the Maintenance password. 

z Indicates that this request is to change the ZAP password. 

Example: 

pw o password 

This command changes the maintenance password to 'PASSWORD'. 

pw z password 

This command changes the zap password to 'PASSWORD'. Refer to 9.5, "How 
to Change the Password and Parse Tables" on page 9-3 in this chapter for more 
complete description of the passwords. 

Note: Do not allow the ZAP password and the Maintenance Facility passwords to 
be equal. Each is a mutually exclusive function and the passwords must be unique 
for proper invocation. 

Error Messages: 

Invalid password type given. 

Invalid password - Password may not begin with blank. 
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9.24 S - Store to CPU Board Memory 



Use the S command to store data to CPU board memory. Up to one line of data 
may be stored at a time. The bytes are stored sequentially, one byte at a time, 
starting at the given address. 

Format: 



s 


seg:offs [bytebyte . 


• •] [byte] 


s 


seg:offs [bytebyte . 


••] 


s 


seg.offs string 





Where: 

seg Specifies the memory segment value, in hex. 

offs Specifies the memory offset, in hex. 

bytebyte Means the representation of two bytes, i.e. 12EF. 

byte Means the representation of one byte, i.e. 2E. 



string 



Means a string of characters surrounded by single quotes. The ASCII 
characters themselves are stored sequentially, starting at the given 
address. All characters between the first and last quote will be stored. 
Any single quotes inside the string will also be stored. 



Notes: 



1. Only one line of characters may be stored. The final quote must appear on the 
current command line. 

2. A check of all given data is done before any data is actually stored in memory. 
If an error occurs, NO data will have been stored. 

Example: 

s DC00.-200 4142 4344 45 

Stores the 5 bytes given in CPU memory starting at segment DCOO and offset 200. 

s DCOO: 200 45 

Stores the 1 byte given in CPU memory starting at segment DCOO and offset 200. 

s DC00:200 45 4142 

Is illegal and an error message will be displayed. 
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s DC00:200 'Isn't it a beautiful day?' 

Stores the phrase "Isn't it a beautiful day?" in CPU memory starting at segment 
DCOO and offset 200. Note that the apostrophe inside the phrase is also stored. 

Error Messages: 

Invalid Segment Specification. 

Invalid Offset Specification. 

Invalid Storage Byte Format. 

No closing delimiter found on ASCII store. 
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9.25 SW - Store One Word into CPU Board Memory 



Use the SW command to store one word into CPU board memory. Only one word 
at a time may be stored. Values may be entered in either upper or lower case, and 
leading zeros are not required. 

Format: 



SW 


segioffs word 



Where: 

seg Specifies the memory segment value, in hex. 
offs Specifies the memory offset, in hex. 
word Is the one word that you wish to store. 

Example: 

sw 8000:40b8 0120 

This command stores the word specified at the given memory location. No 
response is given. 

Error Messages: 

Invalid Segment Specification. 
Invalid Offset Specification. 
Invalid Storage Word. 
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I 9.26 T - Display Terminal Type Information 



Use the T command to display parameters relating to a specific terminal type. Ter- 
minal name may be entered in either upper or lower case, and space filling is not 
required. The response given depends on whether or not the TDT requested is of 
the older type or of the extended type with screen size information. 

Format: 



T 


term 



Where: 

term Is the terminal type for which information is requested. 

Example: 

t ibm3101 

This command requests a display of parameters relating to the IBM3101 terminal 
type. The parameters are shown not byte reversed. A typical response follows, 
assuming a TDT without screen size information: 

All terminal offset values are relative to segment DCOO: 

Address of Terminal Definition Table: 5402 

Flags: 0000 Input Parse Tables: 545E Output Parse Tables: 5414 

Cursor Base: 0020 Host Trans Tables: 436E Term Trans Tables: 4D82 

Reset Chars: 5282 Transmit Delay: 0000 Attribute Params : 528B 

Example 2: 

t vt1005 

This command requests a display of parameters relating to the VT1005 terminal 
type, which is assumed to be a user defined TDT that supports a 3278 Model 5. A 
response for the extended TDT format follows: 



All terminal offset values are relative to segment DC00 
Address of Terminal Definition Table: 0340 
Flags: 0C80 Input Parse Tables: 0402 
Cursor Base: 0001 Host Trans Tables: 8071 
Reset Chars: 03EE Transmit Delay: 0000 



Output Parse Tables 
Term Trans Tables : 
Attribute Params : 



Default Physical Rows, Cols: 



0000 



Default Logical Rows, Cols 



035A 
8070 
03F7 
0000 



Alternate Physical Rows, Cols: 1884 Alternate Logical Rows, Cols: 1B84 

Flags Is the actual value of this terminal's flags. 

Input Parse Tables Pointer to the first level input parse table. 

Output Parse Tables Pointer to the Control String Pointer List. 
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Cursor Base Cursor addressing base. (i.e. position 1 = 1 + cursor 

base) 

Host Trans Tables Pointer to Host EBCDIC to ASCII table. 

Term Trans Tables Pointer to Terminal input and output tables. 

Reset Chars Pointer to IBM 7171 Reset Characters string. 

Transmit delay Delay (in milliseconds) in output of initialization string. 

Attribute Params Pointer to "Set Graphic Rendition" string. 

Default Physical Rows,Cols 

Default Logical Rows,Cols 

Alternate Physical Rows,Cols 

Alternate Logical Rows,Cols 

These values are the 3270 Alternate Screen Size informa- 
tion. 

For a complete description of these values, refer to "Terminal Header Information" 
on page 4-28 in Chapter 4 of this document. 

Error Messages: 

Invalid Terminal Type given. 
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9.27 TM - Display Terminal Controller (TC) Board Memory 



Use the TM command to display memory of any TC board. Up to hex FF bytes of 
TC memory may be displayed at one time. Values may be entered in either upper 
or lower case, and leading zeros are not required. 

Format: 



TM 
TM 


n seg:offs len 
n seg:offs 



Where: 

n Specifies which TC (0-7) boards memory is to be displayed. 

seg Specifies the memory segment value, in hex. 

offs Specifies the memory offset, in hex. 

len Indicates the number of bytes to be displayed, in hex. If length is omitted, 
one byte will be displayed. If length specified is larger than hex FF, FF will 
be the default. 

Example: 

tm 2 : 1 aO 12 

This command requests a display of hex 12 bytes of TC 2 memory starting at 
segment and offset 1A0. A response might be: 

t2 OOOOrOlAO 1234 5678 9ABC DEFO 1234 5678 9ABC DEFO I . 4Vx 4Vx I A 

t2 0000:01B0 1234 I .4 I A 

The 't2' indicates that memory from TC 2 is being displayed. The A/E to the right 
of the dump indicates whether the characters displayed are the ASCII or EBCDIC 
translations of the data dumped. 

Error Messages: 

Invalid segment specification. 

Invalid offset specification. 

Invalid length specification. 

Invalid TC board specification 

TC not inserted. 

Address specified wraps addressability boundary. 
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9.28 TS - Store to Terminal Controller (TC) Board Memory 



Use the TS command to store to TC memory. Only one byte at a time may be 
stored to TC memory. Values may be entered in either upper or lower case, and 
leading zeros are not required. 

Format: 



TS 


n seg:offs byte 



Where: 

n Specifies which TC board is to be stored to. 

seg Specifies the memory segment value, in hex. 
offs Specifies the memory offset, in hex. 
byte Is the one byte that will be stored. 

Example: 

ts 0:1a0 b3 

This command stores the value B3 in TC memory at segment and offset 1A0. 
No response is given. 

Error Messages: 

Invalid segment specification. 
Invalid offset specification. 
Invalid storage byte format. 
Invalid TC board specified. 
TC not inserted. 
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9.29 X - Toggle ASCII/EBCDIC Output Display 



Use the X command to toggle character display on memory dumps between ASCII 
and EBCDIC. The output type is determined by examining the trailing character on 
the output dump. An 'A' indicates ASCII output is selected, an 'E' indicates 
EBCDIC output is selected 

Format: 



X 





Example: 

x 

This command toggles output display format. Responses are: 

ASCII output selected 
EBCDIC output selected 
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9.30 = - Invoke Calculator Functions 



Use the = command to invoke calculator functions. The '=' command is actually 
three commands: '=S', '=T, and '=X\ The character after the '=' indicates what 
default output to select for the answer, ASCII, Decimal, or Hex, respectively. 

Format: 



=s 


val[. 


.op val] 


=T 


val[. 


.op val] 


=X 


val[. 


.op val] 



Where: 

val Specifies any value, or operand. An operand can be specified in two ways: 

num Where 'num' is interpreted to be of the output default type selected 
in the command, either one ASCII character, one decimal value 
where legal characters are 0-9, or hexadecimal where legal charac- 
ters are 0-9 and A-F. 

Nnum Where N is the character *S\ 'T', or 'X'. This character prefix to 
the value overrides the default output type given on the command 
line. The next value is assumed to have a type N, where N is as 
above. Num is assumed to be either an ASCII character, a decimal 
value, or a hexadecimal value, respectively. 

op Specifies the operation to be performed. Only the four basic operations are 
supported. They are: 

+ Adds the value to the left of the plus to the value on the right of the plus. 

- Subtracts the value immediately to the right of the minus from the value 
on the left of the minus. 

* Multiplies the values on the right and left of the '*' together. 

/ Divides the value on the left of the */' by the value on the right of the '/'. 

Warning: Order of operations is LEFT to RIGHT. NO operation 
precedence exists, i.e. the problem 2+3*10 is calculated as 50, NOT 
32. 
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Notes: 

1. NO spaces are allowed in the arithmetic string. Any space is considered a ter- 
mination of the string. 

2. Precision is limited to 16 bits. It is the user's responsibility to account for over- 
flows and carries. All ASCII input is limited to ONE character per operand, 
and ASCII output is limited to two character output. 

3. The high order bit is masked off for ASCII output. It is the user's responsi- 
bility to recognize when this has occurred. Also, all characters from X ' 00 ' to 
X * IF ' are represented by a ':' when they are output. 

Example: 

=x t64 

0040 

Ok 

This command interprets 64 to be in decimal, and displays the answer in HEX. It 
has the effect of translating decimal to hex. Similarly, the command "=x s#" will 
translate the ASCII character '#' into a hexadecimal value. 

=t sO+xa-8/10 

5 

Ok 

This string took the ASCII character (decimal 48) added to it hex A (decimal 10) 
subtracted 8, and then divided by 10. Since no type specifier preceded the 8 or the 
10, both were taken to be decimal numbers since the default output type is decimal. 

Error Messages: 

Improper Arithmetic String. 
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9.31 System Error Messages 

Following is a list of System Error Messages, and their associated parameters: 
Received unsolicited DMA. 

PO Command from TC, after one shift left. 

PI SCCOUT, STCCOUT processing flags. 

P2 TC DMA pending, SCRN buffer status flag. 
Received data or DMA for unconnected line. 

PO Command from TC, after one shift left. 

PI SCCOUT, STCCOUT processing flags. 

P2 TC DMA pending, SCRN buffer status flag. 
CPU sent TC an unsupported command. 

PO Command from TC, after one shift left. 

PI SCCOUT, STCCOUT processing flags. 

P2 TC DMA pending, SCRN buffer status flag. 
KYBD parsed key sequence that generated an invalid routine number. 

PO Register SI, Address of SEQ NODE. 

PI Register AX before shifting. SEQNCALL that triggered error. AL= 

routine #. 

P2 AC2WORK, Character that triggered invalid call, last character in input 
sequence. 

Out of RAM space. 

PO Amount of memory requested. 

PI SCCOUT, STCCOUT processing flags. 

P2 TC DMA pending, SCRN buffer status flag. 
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TCCOUT error 

If the left byte of PO = X ' FF ' Then 

PO Right byte is right byte of Flagword 1. 

PI Flag word 3. 

P2 Data Segment Register. 
Else 

PO Data Segment (DS) register for Device. 

PI Start address of output buffer. 

P2 Count. 
CC was interrupted while previous DMA was pending. 

PO Command from CC. 

PI Device #, SCRN buffer status flag. 

P2 Command from CC of DMA that is pending. 
CC and CPU "chained" miscommunication occurred. 

PO Count of data discarded. 

PI Device #, SCRN buffer status flag. 

P2 Command from CC of DMA that is pending. 
CPU had more than 2 status requests for a device. 

PO Status, Sense which could not be sent. 

PI Status, Sense of first in queue. 

P2 Status, Sense of second in queue. 
CC 3270 data stream buffer too small. Change default. 

PO Count of data discarded. 

PI Status, Sense of first in queue. 

P2 Status, Sense of second in queue. 
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Multiple DMA requests were made to the CC. 

PO Length for requested DMA. 

PI Previous DMA command. 

P2 Device #, SCRN buffer status flag. 
CC DMA timed out. 

PO Length for requested DMA. 

PI Previous DMA command. 

P2 Device #, SCRN buffer status flag. 
Invalid or unexpected interrupt. 

PO Flags Register. 

PI Code Segment Register. 

P2 Program Counter. 

Note: The device number listed is the invalid interrupt number that caused the 
error. 

Read or Read Modified found DMA buffer marked full. 

PO Port command from CC, SCRN flag. 

PI SCRN buffer status flag, Device number. 

P2 AC2 for write datastream. 
Write or Erase/Write found DMA buffer not marked full. 

PO DMA command from CC, SCRN flag. 

PI SCRN buffer status flag, Device number. 

P2 AC2 for write datastream. 
SCRN received illegal command from CC. 

PO DMA command from CC, port command from CC. 

PI SCRN flag, SCRN buffer status. 

P2 AC2 for write datastream. 
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9.32 General Notes 



1. The area used for gathering CC and TC data is initialized to X ' DD ' . Any 
bytes that appear as X ' DD ' may have been the result of miscommunication. 

2. Display of TC and CC memory, and sending of notes all utilize the same work 
area. Care must be taken to make sure that one function is finished before 
initiating another. 
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Appendix A. ASCII and EBCDIC Data Conversion Tables 



This appendix gives the tables used for translating the data transferred between the 
IBM 7171 and the host computer and between the IBM 7171 and ASCII terminals. 



A.1 How to Read These Tables 



To translate a byte of data using these tables, find the most significant digit of the 
byte in the left hand column of indices, then the least significant digit in the top 
row of indices. The row and column that each respective index denotes intersect, 
giving the desired value. An example of a table lookup follows. 







. . 


Least 
Significant Digit 
. . 4 5 6 7 8 9 . . . 


. F 







01 .. 


. . DF 


02 


DF DF 


OC 


DF . . . 


. DF 


Most 


6 


2D . . 


. . DF 


DF 


DF DF 


DF 


DF . . . 


. 3F 


Significant 


7 


DF . . 


. . DF 


DF 


DF DF 


DF 


60 .. . 


. 22 


Digit 


8 


DF . . 


.. 64 


65 


66 67 


68 


69 ... 


. DF 




9 


DF . . 


. . 6D 


6E 


6F 70 


71 


72 .. . 


. DF 




A 


DF .. . 


. . 75 


76 


77 78 


79 


7A . . . 


. DF 




F 


30 . . 


. . 34 


35 


36 37 


38 


39 . .. 


. DF 



Figure A-l. Sample Translation Table 

For example, to translate a X ' 96 ' using this sample table, first find the '9' in the 
left hand column, then find the '6' in the top row. The byte at the place where the 
'9' row and the '6' column intersect is X ' 6F ' , therefore this is the translated value 
ofX'96'. 
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A.2 Host Tables for 3277 Device Types 



These tables are used if the current host SYSGEN supports a 3277 terminal on the 
given line, and the appropriate 3277 override has been made in Non- Volatile RAM 
(NV-RAM). Refer to Chapter 4, "Customizing IBM 7171 Tables" for custom- 
izing tables in NV-RAM. 



A.2.1 3277 Basic Translate Table for Write Data Streams 



This table translates host EBCDIC data to an internal ASCII representation. The 
mapping ranges are: 

X'OO'-X^O 1 : 3270 Data Stream Orders 
X ' 4 1 * -X ' FF ' : EBCDIC Characters 

Illegal EBCDIC characters are denoted in the table by X ' DF • . 

0123456789ABCDEF 

01 DF DF 00 DF 02 DF DF DF DF DF DF 83 84 DF DF 

1 DF 03 04 05 DF 81 DF DF DF 82 DF DF 09 06 0A DF 

2 DF DF DF DF DF DF DF DF DF DF DF 0B DF DF DF DF 

3 DF DF DF DF DF DF DF DF DF DF DF DF 07 DF DF DF 

4 08 DF DF DF DF DF DF DF DF DF 5C 2E 3C 28 2B 7C 

5 26 DF DF DF DF DF DF DF DF DF 2 1 24 2A 29 3B 5E 

6 2D 2F DF DF DF DF DF DF DF DF 86 2C 25 5F 3E 3F 

7 DF 5E DF DF DF DF DF DF DF 60 3A 23 40 27 3D 22 

8 DF 61 62 63 64 65 66 67 68 69 B9 DF DE B3 A4 BD 

9 AC 6A 6B 6C 6D 6E 6F 70 71 72 B8 BA DF AF DF BB 
A A0 7E 73 74 75 76 77 78 79 7A A3 B6 A2 5B BE AA 
B A1 A5 A9 B2 B7 DF DB DD BF DF A7 A8 AE 5D B1 AD 
C 7B 41 42 43 44 45 46 47 48 49 DF DF DF DF DF DF 
D 7D 4A 4B 4C 4D 4E 4F 50 51 52 DF DF DF DF DF DF 
E 85 DF 53 54 55 56 57 58 59 5A DF DF DF DF DF DF 
F 30 31 32 33 34 35 36 37 38 39 DF DF DF DF DF DF 
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A.2.2 3277 Attribute and APL Byte Table for Write Data Streams 



This table translates host attribute or Data Analysis (APL) characters (bytes that 
follow the Start Field X' ID ' order) to an internal representation. 

Illegal attribute or APL characters are denoted in the table by X ' DF ' . 

01 23456789ABCDEF 

DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 00 

1 DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

2 DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

3 DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

4 E0 E1 DF DF E2 E3 DF DF E4 E5 95 94 E6 E7 90 91 

5 E8 E9 DF DF EA EB DF DF EC ED 98 9B EE EF 9D 9C 

6 F0 F1 DF DF F2 F3 DF DF F4 F5 BO AB F6 F7 DF DF 

7 F8 F9 DF DF FA FB DF DF FC FD DF B4 FE FF DF DF 

8 DF C1 C2 C3 C4 C5 C6 C7 C8 C9 DF DF DF DF DF DF 

9 87 CA CB CC CD CE CF DO D1 D2 DF CO DF DF DF DF 
A 88 DF D3 D4 D5 D6 D7 D8 D9 DA DF DF DF BC DC DF 
B DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 
C E0 E1 B5 A6 E2 E3 8D 93 E4 E5 DF DF E6 E7 DF DF 
D E8 E9 9F 96 EA EB 8E 8F EC ED DF DF EE EF DF DF 
E F0 F1 92 97 F2 F3 9A 99 F4 F5 DF DF F6 F7 DF DF 
F F8 F9 DF 9E FA FB DF DF FC FD DF DF FE FF DF DF 
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A.2.3 3277 Basic Translate Table for Read Data Streams 



This table translates the internal ASCII representation of a character to EBCDIC. 
The mapping ranges are: 

X'OO 1 : Null Character 

X'OI'-X'IF': Miscellaneous Control Codes 

X^O'-XWE': Normal ASCII Graphic Characters 

X^F'-X'SC: Special Characters (FM, DUP, NL, EM, FF, CR) 

X'SD'-X'DE 1 : 3278 APL Characters 

X'DF' : Returns X'60' for 3278 Illegal Character 

X'EO'-X'FF': Attribute Characters 

A X ' 00 ' in this table (except for null) means that the character is either an attri- 
bute byte or an APL compound character, and should be translated on the appro- 
priate table. 

123456789ABCDEF 

00 01 02 03 37 2D 2E 2F 16 05 15 0B 0C 26 0E OF 

1 10 11 12 13 3C 3D 32 26 18 19 3F 27 1C 1D 1E 1F 

2 40 5A 7F 7B 5B 6C 50 7D 4D 5D 5C 4E 6B 60 4B 61 

3 F0 F1 F2 F3 F4 F5 F6 F7 F8 F9 7A 5E 4C 7E 6E 6F 

4 7C C1 C2 C3 C4 C5 C6 C7 C8 C9 D1 D2 D3 D4 D5 D6 

5 D7 D8 D9 E2 E3 E4 E5 E6 E7 E8 E9 AD 4A BD 5F 6D 

6 79 81 82 83 84 85 86 87 88 89 91 92 93 94 95 96 

7 97 98 99 A2 A3 A4 A5 A6 A7 A8 A9 CO 4F DO A1 1E 

8 1C 15 19 0C 0D E0 6A 00 00 AD BD 60 60 00 00 00 

9 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
A A0 B0 AC AA 8E B1 00 BA BB B2 AF 00 90 BF BC 9D 
B 00 BE B3 8D 00 00 AB B4 9A 8A 9B 9F 00 8F AE B8 
C 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
D 00 00 00 00 00 00 00 00 00 00 00 B6 00 B7 8C 60 
E 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
F 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
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A.2.4 3277 Attribute and APL Table for Read Data Streams 



) 



This table translates the internal representations of an attribute or 3277 Data Anal- 
ysis (APL) byte to EBCDIC, which will then follow a Start Field X • ID ' order. 
The mapping ranges are: 

X'OO'-X^E' : Unused 

X ' 7F ' -X ' 8C ' : Special Characters 

X'SD'-X'DF 1 : 3277 APL Characters 

X'EO'-X'FF': Attribute Characters 

Illegal attribute or APL bytes are denoted in the table by X ' FF ' . 

1 234567 89ABCDEF 

FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

1 ff FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

2 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

3 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

4 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

5 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

6 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

7 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

8 FF FF FF FF FF FF FF 90 A0 FF FF FF FF C6 D6 D7 

9 4E 4F E2 C7 4B 4A D3 E3 5A E7 E6 5B 5F 5E F3 D2 
A FF FF FF FF FF FF C3 FF FF FF FF 6B FF FF FF FF 
B 6A FF FF FF 7B C2 FF FF FF FF FF FF AD FF FF FF 
C 9B 81 82 83 84 85 86 87 88 89 91 92 93 94 95 96 
D 97 98 99 A2 A3 A4 A5 A6 A7 A8 A9 FF AE FF FF FF 
E 40 C1 C4 C5 C8 C9 4C 4D 50 D1 D4 D5 D8 D9 5C 5D 
F 60 61 E4 E5 E8 E9 6C 6D F0 F1 F4 F5 F8 F9 7C 7D 
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A.3 Host Tables for 3278 Device Types 



These are the default tables used by the IBM 7171, that is, no explicit override to 
use 3277 tables has been made in Non- Volatile RAM. 



A.3.1 3278 Basic Translate Table for Write Data Streams 



This table translates host EBCDIC data to an internal ASCII representation. The 
mapping ranges are: 

X'OO'-X^O 1 : 3270 Data Stream Orders 
X'fll'-X'FF*: EBCDIC Characters 

Illegal EBCDIC characters are denoted in the table by X • DF • . 

0123456789ABCDEF 

01 DF DF 00 DF 02 DF DF 0C DF DF DF 83 84 DF DF 

1 DF 03 04 05 DF 81 DF DF DF 82 DF DF 09 06 0A DF 

2 DF DF DF DF DF DF DF DF DF DF DF 0B DF DF DF DF 

3 DF DF DF DF DF DF DF DF DF DF DF DF 07 DF DF DF 

4 08 DF DF DF DF DF DF DF DF DF 5C 2E 3C 28 2B 7C 

5 26 DF DF DF DF DF DF DF DF DF 21 24 2A 29 3B 5E 

6 2D 2F DF DF DF DF DF DF DF DF 86 2C 25 5F 3E 3F 

7 DF DF DF DF DF DF DF DF DF 60 3A 23 40 27 3D 22 

8 DF 61 62 63 64 65 66 67 68 69 DF DF DF DF DF DF 

9 DF 6A 6B 6C 6D 6E 6F 70 71 72 DF DF DF DF DF DF 
A DF 7E 73 74 75 76 77 78 79 7A DF DF DF 5B DF DF 
B DF DF DF DF DF DF DF DF DF DF DF DF DF 5D DF DF 
C 7B 41 42 43 44 45 46 47 48 49 DF DF DF DF DF DF 
D 7D 4A 4B 4C 4D 4E 4F 50 51 52 DF DF DF DF DF DF 
E 85 DF 53 54 55 56 57 58 59 5A DF DF DF DF DF DF 
F 30 31 32 33 34 35 36 37 38 39 DF DF DF DF DF DF 
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A.3.2 3278 Attribute Byte Table for Write Data Streams 



This table translates host attribute bytes (bytes that follow the Start Field X* ID ' 
order) to an internal representation. 

Illegal attribute characters are denoted in the table by X ' DF ' . 

0123456789ABCDEF 

DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

1 DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

2 DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

3 DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

4 EO E1 DF DF E2 E3 DF DF E4 E5 DF DF E6 E7 DF DF 

5 E8 E9 DF DF EA EB DF DF EC ED DF DF EE EF DF DF 

6 FO F1 DF DF F2 F3 DF DF F4 F5 DF DF F6 F7 DF DF 

7 F8 F9 DF DF FA FB DF DF FC FD DF DF FE FF DF DF 

8 DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

9 DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 
A DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 
B DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 
C EO E1 DF DF E2 E3 DF DF E4 E5 DF DF E6 E7 DF DF 
D E8 E9 DF DF EA EB DF DF EC ED DF DF EE EF DF DF 
E FO F1 DF DF F2 F3 DF DF F4 F5 DF DF F6 F7 DF DF 
F F8 F9 DF DF FA FB DF DF FC FD DF DF FE FF DF DF 
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A.3.3 3278 APL Table for Write Data Streams 



This table translates host APL characters (bytes that follow the Graphic Escape 
X ' 08 * order) to their internal representations. 

Illegal APL characters are denoted in the table by X ' DF * . 

0123456789ABCDEF 

DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

•1 DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

2 DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

3 DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF DF 

4 DF C1 C2 C3 C4 C5 C6 C7 C8 C9 DF DF DF DF DF DF 

5 DF CA CB CC CD CE CF DO D1 D2 DF DF DF DF DF DF 

6 DF DF D3 D4 D5 D6 D7 D8 D9 DA DF DF DF DF DF DF 

7 DF BO A6 DF DF DF DF DF AB DF DF DF DF DF DF DF 

8 B4 DF DF DF DF DF DF DF DF DF B9 B5 DE B3 A4 BD 

9 AC DF DF DF DF DF DF DF DF DF B8 BA CO AF DF BB 
A A0 DF DF DF DF DF DF DF DF DF A3 B6 A2 89 BE AA 
B A1 A5 A9 B2 B7 DF DB DD BF DF A7 A8 AE 8A B1 AD 
C 87 DF DF DF DF DF BC DF DF DF 95 94 DF 90 DF 91 
D 88 DF DF DF DF DF DC DF DF DF 9F 96 8E 8F 98 9B 
E DF DF DF DF DF DF DF DF DF DF 9D 9C DF 92 97 9A 
F DF DF DF DF DF DF DF DF DF DF DF 8D 9E 93 99 DF 
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A.3.4 3278 Basic Translate Table for Read Data Streams 



This table translates the internal ASCII representation of a character to EBCDIC. 
The mapping ranges are: 

X'OO' : Null Character 

X'OI'-X'IF': Miscellaneous Control Codes 

X^O'-XWE 1 : Normal ASCII Graphic Characters 

XWF'-X'SC 1 : Special Characters (FM, DUP, NL, EM, FF, CR) 

X'SD'-X'DE': 3278 APL Characters 

X'DF 1 : Returns X'60' for 3278 Illegal Character 

X'EO'-X'FF 1 : Attribute Characters 

A X ' 00 ' in this table (except for null) means that the character is either an attri- 
bute byte or an APL compound character, and should be translated on the appro- 
priate table. 

1 23456789ABCDEF 

00 01 02 03 37 2D 2E 2F 16 05 15 0B 0C 0D 0E OF 

1 10 11 12 13 3C 3D 32 26 18 19 3F 27 1C 1D 1E 1F 

2 40 5A 7F 7B 5B 6C 50 7D 4D 5D 5C 4E 6B 60 4B 61 

3 F0 F1 F2 F3 F4 F5 F6 F7 F8 F9 7A 5E 4C 7E 6E 6F 

4 7C C1 C2 C3 C4 C5 C6 C7 C8 C9 D1 D2 D3 D4 D5 D6 

5 D7 D8 D9 E2 E3 E4 E5 E6 E7 E8 E9 AD 4A BD 5F 6D 

6 79 81 82 83 84 85 86 87 88 89 91 92 93 94 95 96 

7 97 98 99 A2 A3 A4 A5 A6 A7 A8 A9 CO 4F DO A1 1E 

8 1C 15 19 0C OD EO 6A 00 00 00 00 60 60 00 00 00 

9 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
A 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
B 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
C 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
D 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 60 
E 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
F 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 
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A.3.5 3278 Attribute Byte Table for Read Data Streams 



This table translates the internal representations of an attribute byte to EBCDIC, 
which will then follow a Start Field X ' D ' order. 

Illegal attribute bytes are denoted in the table by X ' FF ' . 

0123456789ABCDEF 

FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

1 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

2 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

3 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

4 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

5 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

6 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

7 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

8 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 

9 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
A FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
B FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
C FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
D FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
E 40 C1 C4 C5 C8 C9 4C 4D 50 D1 D4 D5 D8 D9 5C 5D 
F 60 61 E4 E5 E8 E9 6C 6D F0 F1 F4 F5 F8 F9 7C 7D 
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A.3.6 3278 APL Table for Read Data Streams 



This table translates the internal representation of an APL character to EBCDIC , 
which will then follow a Graphic Escape X • 08 • order. 

Illegal APL characters are denoted in the table by X ' 60 ' . 

01 23456789ABCDEF 

60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 

1 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 

2 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 

3 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 

4 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 

5 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 

6 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 

7 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 

8 60 60 60 60 60 60 60 CO DO AD BD 60 60 FB DC DD 

9 CD CF ED FD CB CA DB EE DE FE EF DF EB EA FC DA 
A A0 B0 AC AA 8E B1 72 BA BB B2 AF 78 90 BF BC 9D 
B 71 BE B3 8D 80 8B AB B4 9A 8A 9B 9F C6 8F AE B8 
C 9C 41 42 43 44 45 46 47 48 49 51 52 53 54 55 56 
D 57 58 59 62 63 64 65 66 67 68 69 B6 D6 B7 8C 60 
E 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 
F 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 60 
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A.4 Terminal Translate Tables 



These tables are used to translate data between ASCII based terminals and the 
IBM 7171 extended ASCII code used in the representation of the terminal screen 
image. Refer to Chapter 4, "Customizing IBM 7171 Tables" for customizing 
tables in NV-RAM. 

Special handling routines are used to convert the data when the byte in the table 
has its high order bit on. The special handling codes are indices into a branch table 
and are defined as follows: 

X'FF* Character is only in other (APL/Non-APL) set 

X'FE' Character is underscored alphabetic 

X'FD 1 Character is general overstrike 

X'FC 1 Character is illegal graphic 

X'FB 1 Character is attribute byte 

X'FA' Character is lowercase (APL tables only) 

X'F9' Character is printer graphic 



A.4.1 Normal (Non-APL) ASCII Output Translate Table 



This table translates a character from the IBM 7171 screen image buffer repres- 
ented by extended ASCII code to normal ASCII code for output to the terminal. 

123456 7 89ABCDEF 

20 FC FC FC FC FC FC FC FC FC FC FC FC FC FC FC 

1 FC FC FC FC FC FC FC FC FC FC FC FC FC FC FC FC 

2 20 21 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F 

3 30 31 32 33 34 35 36 37 38 39 3A 3B 3C 3D 3E 3F 

4 40 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F 

5 50 51 52 53 54 55 56 57 58 59 5A 5B 5C 5D 5E 5F 

6 60 61 62 63 64 65 66 67 68 69 6A 6B 6C 6D 6E 6F 

7 70 71 72 73 74 75 76 77 78 79 7A 7B 7C 7D 7E 3B 

8 2A F9 F9 F9 F9 5C 7C 7B 7D FF FF FC FC FF FF FF 

9 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
A FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
B FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
C FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
D FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FC 
E FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB 
F FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB 
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A.4.2 Normal ASCII Input Translate Table 



This table translates normal terminal input data. A X ' 00 ' byte indicates a control 
string introducer. 

0123456789ABCDEF 

00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

1 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

2 20 21 22 23 24 25 26 27 28 29 2A 2B 2C 2D 2E 2F 

3 30 31 32 33 34 35 36 37 38 39 3A 3B 3C 3D 3E 3F 

4 40 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F 

5 50 51 52 53 54 55 56 57 58 59 5A 5B 5C 5D 5E 5F 

6 60 61 62 63 64 65 66 67 68 69 6A 6B 6C 6D 6E 6F 

7 70 71 72 73 74 75 76 77 78 79 7A 7B 7C 7D 7E 00 
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A.4.3 Typewriter Paired APL Output Translate Table 



This table translates the internal ASCII representation of a character to typewriter 
paired ASCII code for output to a terminal. 

0123456789ABCDEF 

20 FC FC FC FC FC FC FC FC FC FC FC FC FC FC FC 

1 FC FC FC FC FC FC FC FC FC FC FC FC FC FC FC FC 

2 20 FF FF FF 7E FF FF 4B 3A 22 50 2D 2C 5F 2E 2F 

3 30 31 32 33 34 35 36 37 38 39 3E 3C 23 25 26 51 

4 FF 61 62 63 64 65 66 67 68 69 6A 6B 6C 6D 6E 6F 

5 70 71 72 73 74 75 76 77 78 79 7A 3B 3F 27 FF 46 

6 FF FA FA FA FA FA FA FA FA FA FA FA FA FA FA FA 

7 FA FA FA FA FA FA FA FA FA FA FA 7B 4D 7D FF 3C 

8 50 F9 F9 F9 F9 3F 4D 7B 7D 3B 27 FC FC FD FD FD 

9 FD FD FD FD FD FD FD FD FD FD FD FD FD FD FD FD 
A 40 41 42 43 44 45 21 47 48 49 4A 28 4C 4D 4E 4F 
B 29 2A 52 53 54 55 56 57 58 59 5A 5B 5C 5D 5E 2B 
C 60 FE FE FE FE FE FE FE FE FE FE FE FE FE FE FE 
D FE FE FE FE FE FE FE FE FE FE FE 3D 7C 3F 24 FC 
E FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB 
F FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB 
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A.4.4 Typewriter Paired APL Input Translate Table 

This table translates typewriter paired APL terminal input data. 

0123456789ABCDEF 

00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

1 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

2 20 A6 29 3C DE 3D 3E 8A AB BO B1 BF 2C 2B 2E 2F 

3 30 31 32 33 34 35 36 37 38 39 28 89 3B DB 3A DD 

4 AO A1 A2 A3 A4 A5 5F A7 A8 A9 AA 27 AC AD AE AF 

5 2A 3F B2 B3 B4 B5 B6 B7 B8 B9 BA BB BC BD BE 2D 

6 CO 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F 

7 50 51 52 53 54 55 56 57 58 59 5A 7B DC 7D 24 00 
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A.4.5 Bit Paired APL Output Translate Table 



This table translates the internal ASCII representation of a character to bit paired 
ASCII code for output to a terminal. 

0123456789ABCDEF 

20 FC FC FC FC FC FC FC FC FC FC FC FC FC FC FC 

1 FC FC FC FC FC FC FC FC FC FC FC FC FC FC FC FC 

2 20 FF FF FF 7C FF FF 4B 2B 2A 50 2D 2C 3D 2E 2F 

3 30 31 32 33 34 35 36 37 38 39 3E 3C 23 25 27 51 

4 FF 61 62 63 64 65 66 67 68 69 6A 6B 6C 6D 6E 6F 

5 70 71 72 73 74 75 76 77 78 79 7A 3B 3F 3A FF 46 

6 FF FA FA FA FA FA FA FA FA FA FA FA FA FA FA FA 

7 FA FA FA FA FA FA FA FA FA FA FA 5D 4D 7D FF 3C 

8 50 F9 F9 F9 F9 3F 4D 5D 7D 3B 3A FC FC FD FD FD 
.9 FD FD FD FD FD FD FD FD FD FD FD FD FD FD FD FD 

A 22 41 42 43 44 45 21 47 48 49 4A 29 4C 4D 4E 4F 

B 5F 28 52 53 54 55 56 57 58 59 5A 40 5B 60 26 7E 

C 5C FE FE FE FE FE FE FE FE FE FE FE FE FE FE FE 

D FE FE FE FE FE FE FE FE FE FE FE 5E 7B 3F 24 FC 

E FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB 

F FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB FB 
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A. 4. 6 Bit Paired APL Input Translate Table 

This table translates bit paired APL terminal input data. 

0123456789ABCDEF 

00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

1 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 

2 20 A6 A0 3C DE 3D BE 3E B1 AB 29 28 2C 2B 2E 2F 

3 30 31 32 33 34 35 36 37 38 39 8A 89 3B 2D 3A DD 

4 BB A1 A2 A3 A4 A5 5F A7 A8 A9 AA 27 AC AD AE AF 

5 2A 3F B2 B3 B4 B5 B6 B7 B8 B9 BA BC CO 7B DB BO 

6 BD 41 42 43 44 45 46 47 48 49 4A 4B 4C 4D 4E 4F 

7 50 51 52 53 54 55 56 57 58 59 5A DC 24 7D BF 00 
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Appendix B. IBM 7171 Supplied Terminal Definition Tables 



B.l Functions of Specific ASCII Terminals 



This section shows what ASCII character sequences invoke IBM 7171 and host 
functions. Most of this information is given in tables, which contain the key 
sequences for the following ASCII display terminals: 



IBM 3101 

IBM Personal Computer 

Running in 

3101 Emulation Mode 

Televideo TVI 912 

Televideo TVI 920 

Televideo TVI 950 
Lear Siegler ADM 31 
Lear Siegler ADM 3A 
Digital Equipment VT 100 
Datamedia 1520 

Datamedia 1521 

Datamedia Elite 3045 
IBM 3161 and 3163 
ROLM Corporation Cedar, 
Cypress, and Juniper 



seeB.6, "IBM 3101 Terminal" on page B-5 



see B.7, "IBM Personal Computer Running in 

3101 Emulation Mode" on page B-9 

see B.8, "TVI-912 and TVI-920 Terminal" on 

page B-15 

see B.8, "TVI-912 and TVI-920 Terminal" on 

page B-15 

seeB.9, "TVI-950 Terminal" on page B-19 

see B. 10, "ADM-3 1 Terminal" on page B-24 

see B. 11, "ADM-3 A Terminal" on page B-29 

seeB.12, "VT- 100 Terminal" on page B-33 

see B.13, "DM-1520 and DM-1521 Terminal" 

on page B-39 

see B.13, "DM-1520 and DM-1521 Terminal" 

on page B-39 

see B.14, "DM-3045 Terminal" on page B-43 

see B. 15, "IBM 31 6X Terminal" on page B-48 

seeB.16, "ROLM 3270 Terminal" on 
page B-54 



In addition, there are tables which describe basic functions of a typical ASCII type- 
writer terminal without specifying any brand or model. For: 



TYPETERM 



see B.17, "TYPETERM Typewriter Terminal" 
on page B-60 
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B.2 Table Description 



The key settings are shown in three tables for each type of terminal: 

Table 1 - Control and Cursor Movement Keys show the control keys for 3270 emu- 
lated and extended functions. 

Table 2 - Program Functions Keys show regular 3270 PF key functions. 

Table 3 - Setup Functions show setup functions for the extended functions. 

The tables for each terminal type consist of three columns, which are arranged as 
shown in Figure B-l. 



Column 1 


Column 2 


Column 3 


3270 Emulated or 
Extended Function 


Corresponding ASCII 
Code Sequences 


Corresponding Ter- 
minal Key Sequence 
Required 


Shows the 3270 or 
extended function that 
can be initiated from 
the keyboard of the 
ASCII terminal. 


Contains the ASCII 
code sequences that 
initiate the functions 
in column 1 . 


Lists the keys or key 
sequences that corre- 
spond to the ASCII 
codes in column 2. 
These invoke the func- 
tion in column 1 . 



Figure B-l. Table Layout for ASCII Terminal Keyboard Functions 

Notes: 

1. Columns 1 and 2 reflect the contents of the IBM 71 71 supplied Terminal Defi- 
nition Tables that describe the relationship between 3270 or extended functions 
and the ASCII characters that invoke them. 

2. Columns 2 and 3 reflect the relationship between the keys on the specific keyboard 
and the ASCII code sequences generated by each keystroke. 

3. The information in column 3, which refers to the keyboard layout of the partic- 
ular terminal, is supplied without any guarantee, since terminals with the same 
type identification may nevertheless be different. The keys referenced in column 3 
produce the related functions for a terminal of the particular terminal type. This 
column may require changes for a different sub-model of this terminal type. The 
manufacturer-supplied terminal description will describe which key or key 
sequence to press to generate the ASCII code specified in column 2. 
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B.3 Local Reset and Control Functions 



Appended to the three tables describing each terminal type is a short section enti- 
tled Local Reset and Control Functions. The key sequences described here are 
routed directly to the IBM 7171 and are not passed to the host. They provide 
control over the transmission and clearing of data to and from the terminal. 



B.4 Installation Hints 



At the end of each section installation hints are given for the specific terminal type 
when operating the IBM 7171. Switches located on the outer cover of the ter- 
minal, which may be changed without any tools, are described. For any further cus- 
tomizing, refer to the documentation supplied by the manufacturer of the ASCII 
device. 



B.5 Notational Conventions 

In the following tables, an ASCII code will be represented by its displayable char- 
acter representation if the code corresponds to an uppercase or lowercase letter, a 
number, or a convenient special character such as . , : / and so on. 

) If it corresponds to an ASCII control character or a special ASCII character that 

could produce confusion, a mnemonic notation of the ASCII code is used. These 
mnemonics are explained in Figure B-2 on page B-4. 
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00 


NULL 


18 




CAN 








01 


SOH 




19 




EM 








02 


STX 




1A 




SUB 


3A 


: 


COLON 


03 


ETX 




1B 




ESC ESCAPE 


3B 


/ 


SEMI 


04 


EOT 




1C 




FS 


3C 


< 


LESS 


05 


ENQ 


WRU 


1D 




GS 


3D 


= 


EQUAL 


06 


ACK 




1E 




RS 


3E 


> 


GREATER 


07 


BEL 




1F 




US 


3F 


■p 


QUESTION 


08 


BS 




20 




SPACE BLANK 


40 


a 


AT 


09 


HT 


TAB 


21 


i 


EXCLAIM 








0A 


LF 


LINEFEED 


22 


ii 


DQUOTE 








OB 


VT 




23 


# 


POUND 


5B 


[ 


LBRACK 


OC 


FF 


FORMFEED 


24 


$ 


DOLLAR 


5C 


\ 


BSLASH 


OD 


CR 




25 


% 


PERCENT 


5D 


] 


RBRACK 


OE 


SO 




26 


g 


AND 


5E 


A 


UPARROW 


OF 


SI 




27 


i 


QUOTE 


5F 




UNDER 


10 


DLE 




28 


( 


LPAREN 


60 


* 


ACCENT 


11 


DC1 


XON 


29 


) 


RPAREN 








12 


DC2 




2A 


* 


ASTERISK STAR 








13 


DC3 


XOFF 


2B 


+ 


PLUS 


7B 


{ 


LBRACE 


14 


DC4 




2C 


/ 


COMMA 


7C 


1 


BAR 


15 


NAK 




2D 


- 


HYPHEN MINUS 


7D 


} 


RBRACE 


16 


SYN 




2E 


. 


PERIOD DOT 


7E 


~ 


TILDE 


17 


ETB 




2F 


/ 


SLASH 


7F 




DEL 



Figure B-2. ASCII Character Name Table. This table describes the mnemonics used for 
ASCII control characters together with certain special ASCII characters and 
the ASCII code to which they correspond in hexadecimal notation 

If a sequence of ASCII characters is required to invoke a particular function, the 
ASCII characters are separated by commas (",")• If different ASCII code charac- 
ters or character sequences will cause the same function to be executed, these char- 
acters or character sequences are separated by the expression "or." 

If multiple keys have to be pressed on the keyboard to introduce a particular func- 
tion, they are again separated by commas (","). If two or even three keys have to 
be pressed simultaneously, they are concatenated with the word symbol "and." 

If different keys, key sequences or key combinations will invoke the same function, 
they are again separated by using the expression "or." 

In the column describing the keys that have to be pressed, normally the exact 
inscription as it can be found on the keyboard will be used. 
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B.6 IBM 3101 Terminal 



B.6.1 Control and Cursor Movement Keys 



Function 


Corresponding ASCII 


Corresponding IBM 3101 




Code 


Character Seq. 


Key Sequence Required 


Enter 


BS 






4 


Clear 


ESC, 


L 




CLEAR 


Test Request 


ESC, 


J, 


ESC, W 


ERASE EOS, PRINT 


Local Print 


ESC, 


W 




PRINT 


DUP Character 


VT 






ALT and k 


Fieldmark Character 


FF 






ALT and 1 


Cursor Select 


ESC, 


K 




ERASE INPUT 


Redisplay 


SYN 






ALT and v 


Erase Input 


ESC, 


J, 


ESC, K 


ERASE EOS, ERASE INPUT 


Erase EOF 


ESC, 


1 




ERASE EOL/EOF 


Delete Character 


DEL 






DEL 


Toggle Insert Mode 


ESC, 


J, 


DEL 


ERASE EOS, DEL 


Field Tab 


HT 






+ 1 


Field Backtab 


ESC, 


J, 


HT 


ERASE EOS, +| 


Column Tab 


ESC, 


J, 


ESC, C or 


ERASE EOS, -* 




ESC, 


HT 




ESC, -»-| 


Column Backtab 


ESC, 


J, 


ESC, D or 


ERASE EOS, «- 




ESC, 


CR 




ESC, -Kl 


Indent 


ESC, 


J, 


ESC, A 


ERASE EOS, + 


Undent 


ESC, 


J, 


ESC, B 


ERASE EOS, + 


PA1 


ESC, 


J, 


COMMA or 


ERASE EOS, , or 




ESC, 


J, 


LESS or 


ERASE EOS, < or 




ESC, 


J, 


z 


ERASE EOS, z (Note 1) 


PA2 


ESC, 


J, 


PERIOD or 


ERASE EOS, . or 




ESC, 


J, 


GREATER or 


ERASE EOS, > or 




ESC, 


J, 


X 


ERASE EOS, x (Note l) 


PA3 


ESC, 


J, 


SLASH or 


ERASE EOS, / or 




ESC, 


J, 


QUESTION or 


ERASE EOS, ? or 




ESC, 


J, 


c 


ERASE EOS, c (Note 1) 


Newl ine 


CR 






«-J 


Home 


ESC, 


H 




ALT and |-«- 


Cursor Up 


ESC, 


A 




+ 


Cursor Down 


ESC, 


B 




+ 


Cursor Right 


ESC, 


C 




-»■ 


Cursor Left 


ESC, 


D 




-«- 


(Note 1) This characte 


r may 


be 


typed in as up 


percase or lowercase character. 



Figure B-3. Control and Cursor Movement Keys for the IBM 3101 
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B.6.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 


IBM 3101 KEY 




(-Sequence) 






PFK 1 


ESC 


J 


1 


ERASE EOS 


1 


PFK 2 


ESC 


J 


2 


ERASE EOS 


2 


PFK 3 


ESC 


J 


3 


ERASE EOS 


3 


PFK k 


ESC 


J 


k 


ERASE EOS 


k 


PFK 5 


ESC 


J 


5 


ERASE EOS 


5 


PFK 6 


ESC 


J 


6 


ERASE EOS 


6 


PFK 7 


ESC 


J 


7 


ERASE EOS 


7 


PFK 8 


ESC 


J 


8 


ERASE EOS 


8 


PFK 9 


ESC 


J 


9 


ERASE EOS 


9 


PFK 10 


ESC 


J 





ERASE EOS 





PFK 11 


ESC 


J 


HYPHEN 


ERASE EOS 


— 


PFK 12 


ESC 


J 


EQUAL 


ERASE EOS 


= 


PFK 13 


ESC 


J 


EXCLAIM or 


ERASE EOS 


! or 




ESC 


J 


q 


ERASE EOS 


q (Note 1) 


PFK ]k 


ESC 


J 


AT or 


ERASE EOS 


@ or 




ESC 


J 


w 


ERASE EOS 


w (Note 1) 


PFK 15 


ESC 


J 


POUND or 


ERASE EOS 


# or 




ESC 


J 


e 


ERASE EOS 


e (Note 1) 


PFK 16 


ESC 


J 


DOLLAR or 


ERASE EOS 


$ or 




ESC 


J 


r 


ERASE EOS 


r (Note 1) 


PFK 17 


ESC 


J 


PERCENT or 


ERASE EOS 


% or 




ESC 


J 


t 


ERASE EOS 


t (Note 1) 


PFK 18 


ESC 


J 


UPARROW or 


ERASE EOS 


" or 




ESC 


J 


y 


ERASE EOS 


y (Note 1) 


PFK 19 


ESC 


J 


AND or 


ERASE EOS 


6 or 




ESC 


J 


u 


ERASE EOS 


u (Note 1) 


PFK 20 


ESC 


J 


STAR or 


ERASE EOS 


* or 




ESC 


J 


1 


ERASE EOS 


i (Note 1) 


PFK 21 


ESC 


J 


LPAREN or 


ERASE EOS 


( or 




ESC 


J 


o 


ERASE EOS 


o (Note 1) 


PFK 22 


ESC 


J 


RPAREN or 


ERASE EOS 


) or 




ESC 


J 


P 


ERASE EOS 


p (Note 1) 


PFK 23 


ESC 


J 


LBRACK or 


ERASE EOS 


[or 




ESC 


J 


RBRACK or 


ERASE EOS 


] or 




ESC 


J 


UNDER 


ERASE EOS 




PFK 2k 


ESC 


J 


BSLASH or 


ERASE EOS 


\ or 




ESC 


J 


BAR or 


ERASE EOS 


I or 




ESC 


J 


PLUS 


ERASE EOS 


+ 


PFK 25 


ESC 


J 


a 


ERASE EOS 


a (Note 1) 


PFK 26 


ESC 


J 


s 


ERASE EOS 


s (Note 1) 


PFK 27 


ESC 


J 


d 


ERASE EOS 


d (Note 1) 


PFK 28 


ESC 


J 


f 


ERASE EOS 


f (Note 1) 


PFK 29 


ESC 


J 


g 


ERASE EOS 


g (Note 1) 


PFK 30 


ESC 


J 


h 


ERASE EOS 


h (Note 1) 


PFK 31 


ESC 


J 


j 


ERASE EOS 


j (Note 1) 


PFK 32 


ESC 


J 


k 


ERASE EOS 


k (Note 1) 


PFK 33 


ESC 


J 


1 


ERASE EOS 


1 (Note 1) 


PFK Ik 


ESC 


J 


SEMI 


ERASE EOS 


> 


PFK 35 


ESC 


J 


, QUOTE 


ERASE EOS 


i 


PFK 36 


ESC 


J 


, LBRACE or 


ERASE EOS 


! ( or 




ESC 


J 


RBRACE 


ERASE EOS 


} 


(Note 1) This char 


acter 


" mi 


ay be typed in as 


uppercase c 


)r lowercase character. 



Figure B-4. Program Function Keys for the IBM 3101 
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B.6.3 Setup Functions 



The setup functions are introduced by pressing 

ERASE EOS, "ACCENT" (pressed sequentially) 

and then pressing one additional key, which produces the functions listed in 
Figure B-5. 



FUNCTION 


ASCI l-CODE 
(—Sequence) 




IBM 3101 


KEY 


Set Column Tab 


ESC 


J 


ACCENT 


HT 


-N 




Delete Column Tab 


ESC 


J 


ACCENT 


DEL 


DEL 




Set Left Margin 


ESC 


J 


ACCENT 


CR 


-<-J 




Set Home Line 


ESC 


J 


ACCENT 


ESC, H 


ALT and 


|«" 


Delete all Column Tabs, and reset 


ESC 


J 


ACCENT 


ESC, L 


CLEAR 




Home Line and Left Margin 














Improved Null Processing 


ESC 


J 


ACCENT 


N 


N 




3270 Nul 1 Processing 


ESC 


J 


ACCENT 


n 


n 




Zones Mode on 


ESC 


J 


ACCENT 


z 


z 




Zones Mode off 


ESC 


J 


ACCENT 


Z 


Z 




Reverse Enter/Newl ine Keys 


ESC 


J 


ACCENT 


e 


e 




Restore Enter/Newl ine Keys 


ESC 


J 


ACCENT 


E 


E 




Reverse Column and Field Tab Keys 


ESC 


J 


ACCENT 


c 


c 




Restore Column and Field Tab Keys 


ESC 


J 


ACCENT 


C 


C 




Alpha in Numeric-Only Field 


ESC 


J 


ACCENT 


V 


V 




3270 Numeric Fields 


ESC 


J 


ACCENT 


V 


V 




3278 Insert Mode 


ESC 


J 


ACCENT 


i 


i 




3277 Insert Mode 


ESC 


J 


ACCENT 


1 


1 




APL Mode on 


ESC 


J 


ACCENT 


a 


a 




APL Mode off 


ESC 


J 


ACCENT 


A 


A 




ASCI 1 Input in APL Mode 


ESC 


J 


ACCENT 


m 


m 




Alternate Display of Attributes 


ESC 


J 


ACCENT 


d 


d 




Primary Display of Attributes 


ESC 


J 


ACCENT 


D 


D 




Suppress Pacing 


ESC 


J 


ACCENT 


P 


P 




Restore Pacing 


ESC 


J 


ACCENT 


P 


P 




Keyboard initiated Line Drop 


ESC 


J 


ACCENT 


PERIOD 






Return to ENTER TERMINAL TYPE Msg. 


ESC 


J 


ACCENT 


COMMA 


» 




Alternate Keyboard Arrangement 


ESC 


J 


ACCENT 


q 


q 




Primary Keyboard Arrangement 


ESC 


J 


ACCENT 











Figure B-5. Setup Functions for the IBM 3101 
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B.6.4 Local Reset and Control Functions 



There are six key sequences that are completely processed within the IBM 7171, 
and are not passed to the host. These sequences provide a way of controlling and 
clearing the data transmission to and from the terminal: 

ALT and g Master Reset 

ALT and r Character Error Reset 

ALT and t Keyboard Unlock 

ALT and x Type-ahead Purge 

ALT and s Pacing Start 

ALT and q Pacing Stop 



B.6.5 Installation Hints 



There are four 8-position switches 1, 2, 3 and 4 located on top of the keyboard 
under a cover. 

Switches 1 to 3 should be set to match the following requirements: Full-duplex 
EIA RS-232-C Interface with 7 data bits, 1 stop bit, 1 parity bit testing on even 
parity (See Note below). This means that the following settings are required: 

5 6 7 8 position 

u u d u ( required: U = Up, D = Down ) 

d d d d ( suggested: u = up, d = down ) 

d d d d 

Switch 4 selects the transmission rate (baud rate) of the terminal. Positions 1-4 
select terminal baud rate, and positions 5-8 select printer baud rate. The switches 
should have one of the following baud rates (See Note below): 



( U = Up, D = Down ) 



switch 


1 


2 


3 


4 


1 


D 


D 


U 


U 


2 


U 


U 


u 


d 


3 


u 


d 


u 


u 



1/5 


2/6 


3/7 


4/8 


Baud Rate 


D 


D 


U 


U 


300 


D 


U 


D 


D 


600 


D 


U 


D 


U 


1200 


D 


U 


U 


U 


2400 


U 


D 


D 


D 


4800 


U 


D 


D 


U 


9600 
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B.7 IBM Personal Computer Running in 3101 Emulation Mode 



The following key definitions are contained in the YALEIUP.SET sample terminal 
specification file. 



B.7.1 Control and Cursor Movement Keys 



Function 


Corresponding ASCII 


Corresponding 


IBM PC 






Code 


Character Seq. 


Key Sequence Required 




Enter 


BS 




«-J 






C lear 


ESC, 


L 


Home 






Test Request 


ESC, 


J, ESC, W 


PgDn, Esc, W 






Local Print 


ESC, 


W 


Esc, W 






DUP Character 


VT 




Ctrl and k 






Fieldmark Character 


FF 




Ctrl and 1 






Cursor Select 


ESC, 


K 


Ctrl and Home 






Red isplay 


SYN 




Ctrl and v 






Erase Input 


ESC, 


J, ESC, K 


PgDn, Ctrl and Home 




Erase EOF 


ESC, 


I 


End 






Delete Character 


DEL 




Del 






Toggle Insert Mode 


ESC, 


J, DEL 


Ins 






Field Tab 


HT 




-1 






Field Backtab 


ESC, 


J, HT 


PgDn, +| 






Column Tab 


ESC, 


J, ESC, C or 


PgDn, -*■ or 








ESC, 


HT 


ESC, +| 






Column Backtab 


ESC, 


J, ESC, D or 


PgDn, +■ or 








ESC, 


CR 


Esc, 4 






1 ndent 


ESC, 


J, ESC, A 


PgDn, -r 






Undent 


ESC, 


J, ESC, B 


PgDn, + 






PA1 


ESC, 


J, COMMA or 


Alt and Fl or 


PgDn, , 


or 




ESC, 


J, LESS or 


PgDn, < or 








ESC, 


J, z 


PgDn, z (Note 


1) 




PA2 


ESC, 


J, PERIOD or 


Alt and F2 or 


PgDn, . 


or 




ESC, 


J, GREATER or 


PgDn, > or 








ESC, 


J, X 


PgDn, x (Note 


1) 




PA3 


ESC, 


J, SLASH or 


Alt and F3 or 


PgDn, / 


or 




ESC, 


J, QUESTION or 


PgDn, ? or 








ESC, 


J, c 


PgDn, c (Note 


1) 




Newl ine 


CR 




•4 






Home 


ESC, 


H 


Ctrl and PgUp 






Cursor Up 


ESC, 


A 


+ 






Cursor Down 


ESC, 


B 


+ 






Cursor Right 


ESC, 


C 


-► 






Cursor Left 


ESC, 


D 


-«- 






(Note 1) This characte 


r may 


be typed in as up 


percase or lowercase c 


laracter . 



Figure B-6. Control and Cursor Movement Keys for the IBM Personal Computer running in 3101 Emulation Mode 
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B.7.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 
(—Sequence) 


PC Key 


PFK 1 


ESC 


. J 


1 


F1 or PgDn, 1 


PFK 2 


ESC 


, J 


, 2 


F2 or PgDn, 2 


PFK 3 


ESC 


, J 


3 


F3 or PgDn, 3 


PFK 4 


ESC 


. J 


, 4 


F4 or PgDn, 4 


PFK 5 


ESC 


J 


5 


F5 or PgDn, 5 


PFK 6 


ESC 


, J 


6 


F6 or PgDn, 6 


PFK 7 


ESC 


J 


7 


F7 or PgDn, 7 


PFK 8 


ESC 


J 


8 


F8 or PgDn, 8 


PFK 9 


ESC 


J 


8 


F9 or PgDn, 9 


PFK 10 


ESC 


J 


9 


F10 or PgDn, 


PFK 11 


ESC 


J 


HYPHEN 


Shift and F1 or PgDn, - 


PFK 12 


ESC 


J 


EQUAL 


Shift and F2 or PgDn, = 


PFK 13 


ESC 


J 


EXCLAIM or 


Shift and F3 or 




ESC 


J 


q 


PgDn, ! or PgDn, q (Note 1) 


PFK 14 


ESC 


J 


AT or 


Shift and F4 or 




ESC 


J 


w 


PgDn, @ or PgDn, w (Note 1) 


PFK 15 


ESC 


J 


POUND or 


Shift and F5 or 




ESC 


J 


e 


PgDn, # or PgDn, e (Note 1) 


PFK 16 


ESC 


J 


DOLLAR or 


Shift and F6 or 




ESC 


J 


r 


PgDn, $ or PgDn, r (Note 1) 


PFK 17 


ESC 


J 


PERCENT or 


Shift and F7 or 




ESC 


J 


t 


PgDn, % or PgDn, t (Note 1) 


PFK 18 


ESC 


J 


UPARROW or 


Shift and F8 or 




ESC 


J 


y 


PgDn, " or PgDn, y (Note 1 ) 


PFK 19 


ESC 


J 


AND or 


Shift and F9 or 




ESC 


J 


u 


PgDn, & or PgDn, u (Note 1) 


PFK 20 


ESC 


J 


STAR or 


Shift and F10 or 




ESC 


J 


i 


PgDn, * or PgDn, i (Note 1) 


PFK 21 


ESC 


J 


LPAREN or 


Ctrl and F1 or 




ESC 


J 


o 


PgDn, ( or PgDn, o (Note 1) 


PFK 22 


ESC 


J 


RPAREN or 


Ctrl and F2 or 




ESC 


J 


P 


PgDn, ) or PgDn, p (Note 1) 


PFK 23 


ESC 


J 


LBRACK or 


Ctrl and F3 or 




ESC 


J 


RBRACK or 


PgDn, [ or PgDn, ] or 




ESC 


J 


UNDER 


PgDn, 


PFK 24 


ESC 


J 


BSLASH or 


Ctrl and F4 or 




ESC 


J 


BAR or 


PgDn, \ or PgDn, \ or 




ESC 


J 


PLUS 


PgDn, + 


PFK 25 


ESC 


J 


a 


PgDn, a (Note 1) 


PFK 26 


ESC 


J 


s 


PgDn, s (Note 1) 


PFK 27 


ESC 


J 


d 


PgDn, d (Note 1) 


PFK 28 


ESC 


J 


f 


PgDn, f (Note 1) 


PFK 29 


ESC 


J 


g 


PgDn, g (Note 1) 


PFK 30 


ESC 


J 


h 


PgDn, h (Note 1) 


PFK 31 


ESC 


J 


J 


PgDn, j (Note 1) 


PFK 32 


ESC 


J 


k 


PgDn, k (Note 1) 


PFK 33 


ESC 


J 


1 


PgDn, 1 (Note 1) 


PFK 34 


ESC 


J 


SEMI 


PgDn, : 


PFK 35 


ESC 


J 


QUOTE 


PgDn, 


PFK 36 


ESC 


J 


LBRACE or 


PgDn, { or 




ESC 


J 


RBRACE 


PgDn, } 


(Note 1) This char 


acter 


mi 


jy be typed in as 


uppercase or lowercase character. 



Figure B-7. Program Function Keys for the IBM Personal Computer running in 3101 Emulation Mode 
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B.7.3 Setup Functions 



The setup functions are introduced by pressing 

PgDn, "ACCENT" (pressed sequentially) 

and then pressing one additional key, which produces the functions as described in 
Figure B-8. 



FUNCTION 


ASCI l-CODE 
(—Sequence) 




PC KEY 




Set Column Tab 


ESC 


J 


ACCENT 


HT 


-N 




Delete Column Tab 


ESC 


J 


ACCENT 


DEL 


Del 




Set left margin 


ESC 


J 


ACCENT 


CR 


.4 




Set home 1 ine 


ESC 


J 


ACCENT 


ESC, H 


Ctrl and 


PgUp 


Delete all Column Tabs, and reset 


ESC 


J 


ACCENT 


ESC, L 


Home 




Home Line and Left Margin 














Improved Null Processing 


ESC 


J 


ACCENT 


N 


N 




3270 Nul 1 Processing 


ESC 


J 


ACCENT 


n 


n 




Zones Mode on 


ESC 


J 


ACCENT 


z 


z 




Zones Mode off 


ESC 


J 


ACCENT 


Z 


Z 




Reverse Enter/Newl ine Keys 


ESC 


J 


ACCENT 


e 


e 




Restore Enter/Newl i ne Keys 


ESC 


J 


ACCENT 


E 


E 




Reverse Column and Field Tab Keys 


ESC 


J 


ACCENT 


c 


c 




Restore Column and Field Tab Keys 


ESC 


J 


ACCENT 


C 


C 




Alpha in Numeric— Only Field 


ESC 


J 


ACCENT 


V 


V 




3270 Numer ic Fields 


ESC 


J 


ACCENT 


V 


V 




3278 Insert Mode 


ESC 


J 


ACCENT 


i 


i 




3277 Insert Mode 


ESC 


J 


ACCENT 


1 


1 




APL Mode on 


ESC 


J 


ACCENT 


a 


a 




APL Mode off 


ESC 


J 


ACCENT 


A 


A 




ASCI 1 Input in APL Mode 


ESC 


J 


ACCENT 


m 


m 




Alternate Display of Attributes 


ESC 


J 


ACCENT 


d 


d 




Primary Display of Attributes 


ESC 


J 


ACCENT 


D 


D 




Suppress Pacing 


ESC 


J 


ACCENT 


P 


P 




Restore Pacing 


ESC 


J 


ACCENT 


P 


P 




Keyboard initiated Line Drop 


ESC 


J 


ACCENT 


PERIOD 






Return to ENTER TERMINAL TYPE Msg. 


ESC 


J 


ACCENT 


COMMA 


» 




Alternate Keyboard Arrangement 


ESC 


J 


ACCENT 


q 


q 




Primary Keyboard Arrangement 


ESC 


J 


ACCENT 











Figure B-8. Setup Functions for the IBM Personal Computer running in 3101 Emulation Mode 
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B.7.4 Local Reset and Control Functions 



There are six key sequences that are completely processed within the IBM 7171, 
and are not passed to the host. These sequences provide a way of controlling and 
clearing the data transmission to and from the terminal: 



CTRL 


and 


g 


Master Reset 


CTRL 


and 


r 


Character Error Reset 


CTRL 


and 


t 


Keyboard Unlock 


CTRL 


and 


X 


Type-ahead Purge 


CTRL 


and 


s 


Pacing Start 


CTRL 


and 


q 


Pacing Stop 



B.7.5 Installation Hints 

The IBM Personal Computer can be used with the IBM 7171 only when running a 
full screen terminal emulator program. Therefore, the IBM 3101 Emulation 
Program (IBM Program Number 6936712) using the IBM3101 table has to run 
first. 

B.7.6 Starting the 3101 Emulation Program 

Start the Emulation Program using the following steps: 

1. Insert the Emulation Program working diskette in the diskette drive (drive A 
for a two-drive system). 

2. Switch on the computer, or, if the IBM Personal Computer is already switched 
on, hold down the CTRL and ALT keys and at the same time press the DEL 
key. 

3. When prompted, enter the current date in the form mm-dd-yy, where mm is 
the month, dd is the day, and yy is the last two digits of the year. 

4. When prompted, enter the current time in the form hh:mm:ss.xx where hh is 
the hour, mm is the minutes, ss is the seconds, and xx is hundredths of a second 
(ss and xx are not required). 

5. Type in the command "SETUP" 

6. The Emulation Program begins and displays: 

IBM Personal Computer 

IBM 3101 Emulation Program 

Version 1.00 (C) Copyright IBM Corp. 1982 

Program name: Terminal Value Specification 

Function Selection Menu 

Choose: 

1. Select a specification file to run as a terminal 

2. Modify a specification file 

3. Create a specification file 
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4. Exit program 

Type a number and press ENTER: 

7. Now do one of the following: 

a. To use the sample YALEIUP.SET specification file, press '1' to get the fol- 
lowing message: 

Enter filename (or press Enter to return 
to Function Selection Menu) : 

b. To create a new specification file, press '3' to get the following prompt: 

Line speed (Baud rate) enter one of the following 

baud rates: 300,600, 
1200, 2400, 4800, or 
9600 
Block mode enter "N" for Character 

mode 
Half-Duplex? enter "N" for Full-duplex 

Parity? enter "2" for even parity 

Stop Bits? enter " 1 " f or one Stop bit 

Automatic new line enter "Y" or "N" 

Automatic line feed enter "Y" or "N" 

Carriage return? enter "Y" or "N" 

Null suppress? enter "Y" or "N" 

Character sent at End of message? enter "2" for CR 

Scrolling? enter "Y" or "N" 

Prompt character from Host? enter "0" for none 

START/STOP (XON/XOFF) enabled? enter "Y" or "N" 

Note: Line speed and parity selection must conform with the specifications 
defined in the IBM 7171 Ports Area of memory for the appropriate communi- 
cation line. Refer to section 4.4.2, "Ports Area Layout" on page 4-21. 

After the responses have been entered, give this set of specifications a filename 
for future reference. The next time the IBM 3101 Emulation Program is 
called, enter "1" on the above selection list and specify the filename to use the 
new set of specifications. 

After the terminal specifications have been defined the following message 
appears: 

Selection of terminal specifications complete-. 

8. Type in the command "TERMINAL" 

9. The Emulation Program displays: 

IBM Personal Computer 

IBM 3101 Emulation Program 

Version 1.00 (C) Copyright IBM Corp. 1982 

Program name: Terminal Emulation 
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10. Wait a few seconds. When the copyright notice disappears the message 
appears: 

♦♦♦Establish connection if necessary*** 

At this point, if the line is a switched line, connection must be established. 
Then press the ENTER key and from now on the IBM Personal Computer will 
operate in 3101 emulation mode. Continue with the logon procedure. 
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B.8 TVI-912 and TVI-920 Terminal 



The following tables apply for both TVI-912 and TVI-920 terminals. 



B.8.1 Control and Cursor Movement Keys 



Funct ion 


Corresponding ASCII 


Corresponding TV I - 


-912/920 




Code 


Character Seq. 


Key Sequence Required 


Enter 


CR 




RETURN (Note 1) or 
CTRL and m 




Clear 


SUB 




CLEAR SPACE 




Test Request 


- 




— 




Local Print 


— 




— 




DUP Character 


— 




— 




Fieldmark Character 


- 




— 




Cursor Select 


- 




— 




Redisplay 


SYN 




Ctrl and v 




Erase Input 


— 




— 




Erase EOF 


SOH, 


DEL, CR 


FUNCT and RUBOUT 




Delete Character 


DEL 




RUBOUT 




Toggle Insert Mode 


ESC 




ESC 




Field Tab 


SOH, 


FF, CR 


FUNCT and ■> 




Field Backtab 


SOH, 


BS, CR 


FUNCT and «- 




Column Tab 


HT 




TAB (Note l) 




Column Backtab 


SOH, 


HT, CR 


FUNCT and TAB (Note l) 


1 ndent 


SOH, 


VT, CR 


FUNCT and + 




Undent 


SOH, 


LF, CR 


FUNCT and + 




PA1 


SOH, 


COMMA, CR or 


FUNCT and , (Note 


1) or 




SOH, 


LESS, CR 


FUNCT and < 




PA2 


SOH, 


PERIOD, CR or 


FUNCT and . (Note 


1) or 




SOH, 


GREATER, CR 


FUNCT and > 




PA3 


SOH, 


SLASH, CR or 


FUNCT and / or 






SOH, 


QUESTION, CR 


FUNCT and ? 




Newl ine 


RS 




HOME or 

CTRL and ~ or 

CTRL and * 




Home 


SOH, 


RS, CR 


FUNCT and HOME 




Cursor Up 


VT 




■+ or CTRL and k 




Cursor Down 


LF 




+ or CTRL and j or 








LINE FEED 




Cursor Right 


FF 




-*• or CTRL and 1 




Cursor Left 


BS 




-«- or CTRL and h 




(Note l) This key can 


be found on the main ke 


ypad as wel 1 as on 


the 


additional numeric key 


pad on the right side o 


f the TVI-912/920 




keyboard. 











Figure B-9. Control and Cursor Movement Keys for the Televideo TVI-912/920 
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B.8.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 
(-Sequence) 


TVI-912/920 KEY 


PFK 1 


SOH, 1, CR 


FUNCT and 1 (Note 1) 


PFK 2 


SOH 


2, CR 


FUNCT and 2 (Note 1) 


PFK 3 


SOH 


3, CR 


FUNCT and 3 (Note 1) 


PFK k 


SOH 


k, CR 


FUNCT and k (Note 1) 


PFK 5 


SOH 


5, CR 


FUNCT and 5 (Note 1) 


PFK 6 


SOH 


6, CR 


FUNCT and 6 (Note 1) 


PFK 7 


SOH 


7, CR 


FUNCT and 7 (Note 1) 


PFK 8 


SOH 


8, CR 


FUNCT and 8 (Note 1) 


PFK 9 


SOH 


9, CR 


FUNCT and 9 (Note 1) 


PFK 10 


SOH 


0, CR 


FUNCT and (Note 1) 


PFK 11 


SOH 


HYPHEN, CR 


FUNCT and - 


PFK 12 


SOH 


EQUAL, CR 


FUNCT and = 


PFK 13 


SOH 


EXCLAIM, CR or 


FUNCT and ! or 




SOH 


q, CR 


FUNCT and q (Note 2) 


PFK 14 


SOH 


AT, CR or 


FUNCT and 6 or 




SOH 


w, CR 


FUNCT and w (Note 2) 


PFK 15 


SOH 


POUND, CR or 


FUNCT and # or 




SOH 


e, CR 


FUNCT and e (Note 2) 


PFK 16 


SOH 


DOLLAR, CR or 


FUNCT and $ or 




SOH 


r, CR 


FUNCT and r (Note 2) 


PFK 17 


SOH 


PERCENT, CR or 


FUNCT and % or 




SOH 


t, CR 


FUNCT and t (Note 2) 


PFK 18 


SOH 


UPARROW, CR or 


FUNCT and A or 




SOH 


y, CR 


FUNCT and y (Note 2) 


PFK 19 


SOH 


AND, CR or 


FUNCT and & or 




SOH 


u, CR 


FUNCT and u (Note 2) 


PFK 20 


SOH 


ASTERISK, CR or 


FUNCT and * or 




SOH 


i, CR 


FUNCT and i (Note 2) 


PFK 21 


SOH 


LPAREN, CR or 


FUNCT and ( or 




SOH 


o, CR 


FUNCT and o (Note 2) 


PFK 22 


SOH 


RPAREN, CR or 


FUNCT and ) or 




SOH 


p, CR 


FUNCT and p (Note 2) 


PFK 23 


SOH 


LBRACK, CR or 


FUNCT and [ or 




SOH 


RBRACK, CR or 


FUNCT and ] or 




SOH 


UNDER, CR 


FUNCT and 


PFK 2k 


SOH 


BSLASH, CR or 


FUNCT and \ or 




SOH 


BAR, CR or 


FUNCT and [ or 




SOH 


PLUS, CR 


FUNCT and + 


PFK 25 


SOH 


a, CR 


FUNCT and a (Note 2) 


PFK 26 


SOH 


s, CR 


FUNCT and s (Note 2) 


PFK 27 


SOH 


d, CR 


FUNCT and d (Note 2) 


PFK 28 


SOH 


f, CR 


FUNCT and f (Note 2) 


PFK 29 


SOH 


g, CR 


FUNCT and g (Note 2) 


PFK 30 


SOH 


h, CR 


FUNCT and h (Note 2) 


PFK 31 


SOH 


j, CR 


FUNCT and j (Note 2) 


PFK 32 


SOH 


, k, CR 


FUNCT and k (Note 2) 


PFK 33 


SOH 


1, CR 


FUNCT and 1 (Note 2) 


PFK 3k 


SOH 


, SEMI, CR 


FUNCT and : 


PFK 35 


SOH 


, QUOTE, CR 


FUNCT and f 


PFK 36 


SOH 


, LBRACE, CR or 


FUNCT and { or 




SOH 


, RBRACE, CR 


FUNCT and } 


(Note 1) This key 


can be found on the main 


keypad as well as on the 


additional numeric 


keypad on the right s 1 d 


e of the TVI-912/920 


keyboard. 






(Note 2) This char 


acter may be typed in as 


uppercase or lowercase character. 



Figure B-10. Program Function Keys for the Televideo TVI-912/920 
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B.8.3 Setup Functions 



The setup functions are introduced by pressing 

FUNCT and "ACCENT" (pressed simultaneously) 

and then pressing one additional key, which produces the functions as shown in 
Figure B-ll. 



FUNCTION 



ASCI l-CODE 






TV 1-9 12/920 


(—Sequence) 






KEY 


SOH, ACCENT 


CR 


HT 


TAB (Note 1) 


SOH 


, ACCENT 


CR 


, DEL 


RUBOUT 


SOH 


ACCENT 


CR 


RS 


HOME 


SOH 


, ACCENT 


CR 


ESC 


ESC 


SOH 


ACCENT 


CR 


SUB 


CLEAR SPACE 


SOH 


ACCENT 


CR 


N 


N 


SOH 


ACCENT 


CR 


n 


n 


SOH 


ACCENT 


CR 


z 


z 


SOH 


ACCENT 


CR 


Z 


Z 


SOH 


ACCENT 


CR 


e 


e 


SOH 


ACCENT 


CR 


E 


E 


SOH 


ACCENT 


CR 


c 


c 


SOH 


ACCENT 


CR 


C 


C 


SOH 


ACCENT 


CR 


V 


V 


SOH 


ACCENT 


CR 


V 


V 


SOH 


ACCENT 


CR 


i 


i 


SOH 


ACCENT 


CR 


1 


1 


SOH 


ACCENT 


CR 


a 


a 


SOH 


ACCENT 


CR 


A 


A 


SOH 


ACCENT 


CR 


m 


m 


SOH 


ACCENT 


CR 


d 


d 


SOH 


ACCENT 


CR 


D 


D 


SOH 


ACCENT 


CR 


P 


P 


SOH 


ACCENT 


CR 


P 


P 


SOH 


ACCENT 


CR 


PERIOD 




SOH 


ACCENT 


CR 


COMMA 


» 


SOH 


ACCENT 


CR 


q 


q 


SOH 


ACCENT 


CR 


Q 






Set Column Tab 

Delete Column Tab 

Set left margin 

Set home 1 i ne 

Delete all Column Tabs, and reset 

Home Line and Left Margin 
Improved Null Processing 
3270 Nul 1 Processing 
Zones Mode on 
Zones Mode off 
Reverse Enter/Newl ine Keys 
Restore Enter/Newl ine Keys 
Reverse Column and Field Tab Keys 
Restore Column and Field Tab Keys 
Alpha in Numeric-Only Field 
3270 Numeric Fields 
3278 Insert Mode 
3277 Insert Mode 
APL Mode on 
APL Mode off 
ASCI I Input in APL Mode 
Alternate Display of Attributes 
Primary Display of Attributes 
Suppress Pacing 
Restore Pacing 
Keyboard initiated Line Drop 
Return to ENTER TERMINAL TYPE Msg. 
Alternate Keyboard Arrangement 
Primary Keyboard Arrangement 



(Note 1) This key can be found on 
additional numeric keypad on the r 



the main keypad as well as on the 
ight side of the TVI-912/920 keyboard. 



Figure B-ll. Setup Functions for the Televideo TVI-912/920 



B.8.4 Local Reset and Control Functions 



There are six key sequences that are completely processed within the IBM 7171, 
and are not passed to the host. These sequences provide a way of controlling and 
clearing the data transmission to and from the terminal: 



CTRL and g 
CTRL and r 
CTRL and t 
CTRL and x 
CTRL and s 
CTRL and q 



Master Reset 
Character Error Reset 
Keyboard Unlock 
Type-ahead Purge 
Pacing Start 
Pacing Stop 
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B.8.5 Installation Hints 



There are two 10-position switches SI and S2 located on the rear side of the Tele- 
video TVI-9 12/920. 

SI selects the transmission rate (baud rate). Only one switch may be down at a 
time. One of the following switches must be down to select the baud rate indicated 
in the right column (See Note) : 



2 


- 


9600 


baud 


3 


- 


4800 


baud 


4 


- 


2400 


baud 


5 


- 


1200 


baud 


6 


- 


600 


baud 


7 


- 


300 


baud 



Do not select 19200 baud by setting switch 1. This will cause transmission errors. 

Switch S2 specifies some functions. The switches must be set from left (1) to right 
(10) as follows: ( U = Up, D = Down ) 

UDUDDDDUUD (50 Hz Refresh) 

or 

UDUUDDDUUD (60 Hz Refresh) 

Meaning of switches: 



1 


- up 


required 




2 


- down 


Standard Character Set 


3 


- up 


full duplex 




4 


- down 


50 Hz or 






- up 


60 Hz 




5 


- down 


send parity 


(See Note) 


6 


- down 


1 stop bit 




7 


- down 


7 data bits 




8 


- up 


7 data bits 




9 


- up 


even parity 


(See Note) 


10 


- down 


required 





Note: Line speed and parity selection must conform with the specifications defined 
in the IBM 7171 Ports Area of memory for the appropriate communication line. 
Refer to section 4.4.2, "Ports Area Layout" on page 4-21. 
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B.9 TVI-950 Terminal 



If the IBM 7171 sends the message: "enter terminal type:" to the TVI-950, two 
terminal types may be specified: 

TVI950 The normal output is written to the screen using half intensity. The 

highlighted output is written to the screen using full intensity. 

TVI950R The normal output is written to the screen using full intensity. The 

highlighted output is written to the screen using reverse video. 



B.9.1 Control and Cursor Movement Keys 



Funct ion 


Corresponding ASCII 


Corresponding TVI-950 




Code Character Seq. 


Key Sequence Required 


Enter 


CR 




RETURN or 
ENTER or 
CTRL and m 


C lear 


SUB 




CLEAR SPACE or 
CTRL and z 


Test Request 


ESC 


6 or 


SHIFT and SEND or 




ESC 


ESC, 7 


ESC, SEND 


Local Print 


ESC 


ESC, E 


ESC, LINE INSERT 


DOT Character 


ESC 


ESC, Q. 


ESC, CHAR INSERT 


Fieldmark Character 


ESC 


ESC, W 


ESC, CHAR DELETE 


Cursor Select 


ESC 


7 


SEND 


Redi splay 


ESC 


ASTERISK 


ESC and * or 
CTRL and g 


Erase Input 


ESC 


ESC, R 


ESC, LINE DELETE 


Erase EOF 


ESC 


R 


LINE DELETE 


Delete Character 


DEL 




DEL 


Toggle Insert Mode 


ESC 


E 


LINE INSERT 


Field Tab 


ESC 


T 


LINE ERASE 


Field Backtab 


ESC 


t or 


SHIFT and LINE ERASE or 




ESC 


ESC, T 


ESC, LINE ERASE 


Column Tab 


HT 




TAB 


Column Backtab 


ESC 


I 


BACKTAB 


1 ndent 


ESC 


Y 


PAGE ERASE 


Undent 


ESC 


y or 


SHIFT and PAGE ERASE or 




ESC 


ESC, Y 


ESC, PAGE ERASE 


PA1 


SOH 


COMMA, CR or 


FUNCT and , (Note 1) or 




SOH 


LESS, CR 


FUNCT and < 


PA2 


SOH 


PERIOD, CR or 


FUNCT and . (Note 1) or 




SOH 


GREATER, CR 


FUNCT and > 


PA3 


SOH 


SLASH, CR or 


FUNCT and / or 




SOH 


QUESTION ,CR 


FUNCT and ? 


Newl ine 


LF 




LINE FEED or CTRL and j 


Home 


RS 




HOME or CTRL and * 


Cursor Up 


VT 




+ or CTRL and k 


Cursor Down 


SYN 


or LF 


+ or CTRL and v 


Cursor Right 


FF 




-»■ or CTRL and 1 


Cursor Left 


BS 




■+■ or CTRL and h or 
BACKSPACE 


(Note 1 ) Th is key can 


be fc 


)und on the main ke 


ypad as well as on the 


additional numeric key 


pad c 


m the r ight s ide o 


f the TVI-950 keyboard. 



Figure B-12. Control and Cursor Movement Keys for the Televideo TVI-950 
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B.9.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 
(-Sequence) 


TV 1-950 Key 


PFK 1 


SOH, AT, CR 


F1 or FUNCT and 6 


PFK 2 


SOH, A, CR 


F2 or FUNCT and A 


PFK 3 


SOH, B, CR 


F3 or FUNCT and B 


PFK 4 


SOH, C, CR 


F4 or FUNCT and C 


PFK 5 


SOH, D, CR 


F5 or FUNCT and D 


PFK 6 


SOH, E, CR 


F6 or FUNCT and E 


PFK 7 


SOH, F, CR 


F7 or FUNCT and F 


PFK 8 


SOH, G, CR 


F8 or FUNCT and G 


PFK 9 


SOH, H, CR 


F9 or FUNCT and H 


PFK 10 


SOH, 1 , CR 


F10 or FUNCT and 1 


PFK 11 


SOH, J, CR 


F11 or FUNCT and J 


PFK 12 


ESC, 0. 


CHAR INSERT 


PFK 13 


SOH, ACCENT, CR 


SHIFT and F1 or 
FUNCT and * 


PFK 14 


SOH, a, CR 


SHIFT and F2 or 
FUNCT and a 


PFK 15 


SOH, b, CR 


SHIFT and F3 or 
FUNCT and b 


PFK 16 


SOH, c, CR 


SHIFT and ?k or 
FUNCT and c 


PFK 17 


SOH, d, CR 


SHIFT and F5 or 
FUNCT and d 


PFK 18 


SOH, e, CR 


SHIFT and F6 or 
FUNCT and e 


PFK 19 


SOH, f, CR 


SHIFT and F7 or 
FUNCT and f 


PFK 20 


SOH, g, CR 


SHIFT and F8 or 
FUNCT and g 


PFK 21 


SOH, h, CR 


SHIFT and F9 or 
FUNCT and h 


PFK 22 


SOH, i , CR 


SHIFT and F10 or 
FUNCT and i 


PFK 23 


SOH, j, CR 


SHIFT and F11 or 
FUNCT and j 


PFK 2k 


ESC, q 


SHIFT and CHAR INSERT 



Figure B-13. Program Function Keys for the Televideo TVI-950 
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B.9.3 Setup Functions 



The setup functions are introduced by pressing 

SHIFT and LINE DELETE (pressed simultaneously) 

and then pressing one additional key, which will produce the functions as shown in 
Figure B-14. 



FUNCTION 


ASCI l-CODE 
(-Sequence) 


TV 1-950 KEY 


Set Column Tab 


ESC 





HT 


TAB 


Delete Column Tab 


ESC 





DEL 


DELETE 


Set left margin 


ESC 





LF 


LINE FEED 


Set home 1 ine 


ESC 





RS 


HOME 


Delete all Column Tabs, and reset 


ESC 





SUB 


CLEAR SPACE 


Home Line and Left Margin 










Improved Null Processing 


ESC 





N 


N 


3270 Nul 1 Processing 


ESC 





n 


n 


Zones Mode on 


ESC 





z 


z 


Zones Mode off 


ESC 





Z 


Z 


Reverse Enter/Newl ine Keys 


ESC 





e 


e 


Restore Enter/Newl ine Keys 


ESC 





E 


E 


Reverse Column and Field Tab Keys 


ESC 





c 


c 


Restore Column and Field Tab Keys 


ESC 





C 


C 


Alpha in Numeric-Only Field 


ESC 





V 


V 


3270 Numeric Fields 


ESC 





V 


V 


3278 Insert Mode 


ESC 





i 


i 


3277 Insert Mode 


ESC 





1 


1 


APL Mode on 


ESC 





a 


a 


APL Mode off 


ESC 





A 


A 


ASCI 1 Input in APL Mode 


ESC 





m 


m 


Alternate Display of Attributes 


ESC 





d 


d 


Primary Display of Attributes 


ESC 





D 


D 


Suppress Pacing 


ESC 





P 


P 


Restore Pacing 


ESC 





P 


P 


Keyboard initiated Line Drop 


ESC 





PERIOD 




Return to ENTER TERMINAL TYPE Msg. 


ESC 





COMMA 


9 


Alternate Keyboard Arrangement 


ESC 





q 


q 


Primary Keyboard Arrangement 


ESC 





Q 


o. 



Figure B-14. Setup Functions for the Televideo TVI-950 



Note: The ESC/LOC ESC-key on the TVI-950 keyboard is also used to invoke 
some local terminal display features (e.g. setting up a reverse background or special 
graphic symbols). 
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B.9.4 Local Reset and Control Functions 



There are six key sequences that are completely processed within the IBM 7171, 
and are not passed to the host. These sequences provide a way of controlling and 
clearing the data transmission to and from the terminal: 



CTRL 


and 


g 


Master Reset 


CTRL 


and 


r 


Character Error Reset 


CTRL 


and 


t 


Keyboard Unlock 


CTRL 


and 


X 


Type-ahead Purge 


CTRL 


and 


s 


Pacing Start 


CTRL 


and 


q 


Pacing Stop 



B.9.5 Installation Hints 



Use the EIA RS-232-C Interface in full duplex mode with 7 data bits, 1 stop bit 
and 1 parity bit testing on even parity (See Note). 

There are two 10-position switches SI and S2 located on the rear side of the Tele- 
video TVI-950. 

SI selects the transmission rate (baud rate), S2 selects the setting for parity. See 
Figure B-15 on page B-23 for appropriate setting of the switches and selection of 
baud rates. 

Note: Line speed and parity selection must conform with the specifications defined 
in the IBM 7171 Ports Area of memory for the appropriate communication line. 
Refer to section 4.4.2, "Ports Area Layout" on page 4-21. 
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S1 



S2 



DIP 


SWITCH 


1, 


2 


3 


4 


5 








6 








V, 


8 


9 


10 



POSITION (U=up,D=down) 



FUNCTION 



Computer baud rate (see below) 
Seven-bit word structure 
One stop bit 
Printer baud rate (see below) 







DIP 


SWITCHES 




Terminal : 


1 


2 


3 


4 




Printer : 


7 


8 


9 


10 


BAUD RATE 




D 


U 


U 


D 


300 




U 


U 


U 


D 


600 




D 


D 


D 


U 


1200 




D 


U 


D 


U 


2400 




D 


D 


U 


U 


4800 




D 


U 


U 


U 


9600 




U 


U 


u 


U 


19200 



DIP SWITCH 


POSITION 


1 


U 


2 


U 


3,4,5 


D U U 


6 


U 


7,8 


D U 


9 


D or U 


10 


D or U 



FUNCTION 



Duplex edit 

Blinking cursor 

Even parity (receive/transmit; 

Green on black display 

Full duplex communication 

50 Hertz or 60 Hertz 

Keyclick on or off 



Figure B-l 5. Dipswitch Setting for the Televideo TVI-950 
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B.10 ADM-31 Terminal 



B.10.1 Control and Cursor Movement Keys 



Funct ion 


Corresponding ASCII 


Corresponding ADM- 


■31 




Code 


Character Seq. 


Key Sequence Required 


Enter 


CR 




RETURN (Note 1) or 
CTRL and m 




Clear 


ESC, 


W 


CHAR DELETE 




Test Request 


ESC, 


ESC, 5 


ESC, SEND PAGE 




Local Print 


ESC, 


ESC, E 


ESC, LINE INSERT 




DUP Character 


ESC, 


ESC, Q. 


ESC, CHAR INSERT 




Fieldmark Character 


ESC, 


ESC, W 


ESC, CHAR DELETE 




Cursor Select 


ESC, 


5 


SEND PAGE 




Redisplay 


SYN 




CTRL and v 




Erase Input 


ESC, 


ESC, R 


ESC, LINE DELETE 




Erase EOF 


ESC, 


R 


LINE DELETE 




Delete Character 


DEL 




RUB 




Toggle Insert Mode 


ESC, 


E 


LINE INSERT 




Field Tab 


ESC, 


T 


LINE ERASE 




Field Backtab 


ESC, 


ESC, T 


ESC, LINE ERASE 




Column Tab 


HT 




TAB (Note 1) 




Column Backtab 


ESC, 


I 


BACKTAB 




1 ndent 


ESC, 


Y 


PAGE ERASE 




Undent 


ESC, 


ESC, Y 


ESC, PAGE ERASE 




PA1 


SOH, 


COMMA, CR or 


FUNCTION, , (Note 


1) or 




SOH, 


LESS, CR 


FUNCTION, < 




PA2 


SOH, 


PERIOD, CR or 


FUNCTION, . (Note 


1) or 




SOH, 


GREATER, CR 


FUNCTION, > 




PA3 


SOH, 


SLASH, CR or 


FUNCTION, / or 






SOH, 


QUESTION, CR 


FUNCTION, ? 




Newl ine 


US 




PAGE NEWL INE 




Home 


RS 




HOME or CTRL and " 




Cursor Up 


VT 




f or CTRL and k 




Cursor Down 


LF 




+ or CTRL and j or 








LINE FEED 




Cursor Right 


FF 




->■ or CTRL and 1 




Cursor Left 


BS 




-«- or CTRL and h 




(Note 1 ) This key can 


be found on the main ke 


ypad as wel 1 as on 


the 


additional numeric key 


pad on the right side o 


f the ADM-31 keyboard. 



Figure B-16. Control and Cursor Movement Keys for the Lear Siegler ADM-31 



B-24 IBM 7171 Reference Manual and Programming Guide 



B.10.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 


ADM-31 KEY 




(-Sequence) 






PFK 1 


SOH, 1, CR 


FUNCTION 


1 (Note 1) 


PFK 2 


SOH 


2, CR 


FUNCTION 


2 (Note 1) 


PFK 3 


SOH 


3, CR 


FUNCTION 


3 (Note 1) 


PFK k 


SOH 


4, CR 


FUNCTION 


4 (Note 1) 


PFK 5 


SOH 


5, CR 


FUNCTION 


5 (Note 1) 


PFK 6 


SOH 


6, CR 


FUNCTION 


6 (Note 1) 


PFK 7 


SOH 


7, CR 


FUNCTION 


7 (Note 1) 


PFK 8 


SOH 


8, CR 


FUNCTION 


8 (Note 1) 


PFK 9 


SOH 


9, CR 


FUNCTION 


9 (Note 1) 


PFK 10 


SOH 


0, CR 


FUNCTION 


(Note 1) 


PFK 11 


SOH 


HYPHEN, CR 


FUNCTION 


- (Note 1) 


PFK 12 


SOH 


UPARROW, CR 


FUNCTION 


/s 


PFK 13 


SOH 


EXCLAIM, CR or 


FUNCTION 


! or 




SOH 


q, CR 


FUNCTION 


q (Note 2) 
M or 


PFK 14 


SOH 


DQUOTE, CR or 


FUNCTION 




SOH 


w, CR 


FUNCTION 


w (Note 2) 


PFK 15 


SOH 


POUND, CR or 


FUNCTION 


# or 




SOH 


e, CR 


FUNCTION 


e (Note 2) 


PFK 16 


SOH 


DOLLAR, CR or 


FUNCTION 


$ or 




SOH 


r, CR 


FUNCTION 


r (Note 2) 


PFK 17 


SOH 


PERCENT, CR or 


FUNCTION 


% or 




SOH 


t, CR 


FUNCTION 


t (Note 2) 


PFK 18 


SOH 


AND, CR or 


FUNCTION 


& or 




SOH 


y, CR 


FUNCTION 


y (Note 2) 


PFK 19 


SOH 


ACCENT, CR or 


FUNCTION 


^ or 




SOH 


u, CR 


FUNCTION 


u (Note 2) 


PFK 20 


SOH 


LPAREN, CR or 


FUNCTION 


* or 




SOH 


ASTERISK, CR or 


FUNCTION 




SOH 


i, CR 


FUNCTION 


i (Note 2) 


PFK 21 


SOH 


RPAREN, CR or 


FUNCTION 


) or 




SOH 


o, CR 


FUNCTION 


o (Note 2) 


PFK 22 


SOH 


p, CR 


FUNCTION 


p (Note 2) 


PFK 23 


SOH 


, AT, CR or 


FUNCTION 


@ or 




SOH 


EQUAL, CR or 


FUNCTION 


= or 




SOH 


UNDER, CR 


FUNCTION 




(Note 1) This key 


can be found on the main 


keypad as 


well as on the 


additional numeric 


keypad on the right sid 


e of the AC 


)M— 3 1 keyboard. 


(Note 2) This char 


acter may be typed in as 


uppercase 


or lowercase character. 



Figure B-17 (Part 1 of 2). Program Function Keys for the Lear Siegler ADM-31 
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FUNCTION 


ASCI l-CODE 


ADM-31 KEY 






(—Sequence) 








PFK 2k 


SOH, LBRACK, CR or 


FUNCTION 


[ or 






SOH, TILDE, CR or 


FUNCTION 


~ or 






SOH, BSLASH, CR or 


FUNCTION 


\ or 






SOH, BAR, CR or 


FUNCTION 


! or 






SOH, PLUS, CR 


FUNCTION 


+ 




PFK 25 


SOH, a, CR 


FUNCTION 


a (Note 1) 




PFK 26 


SOH, s, CR 


FUNCTION 


s (Note 1) 




PFK 27 


SOH, d, CR 


FUNCTION 


d (Note 1) 




PFK 28 


SOH, f, CR 


FUNCTION 


f (Note 1) 




PFK 29 


SOH, g, CR 


FUNCTION 


g (Note 1) 




PFK 30 


SOH, h, CR 


FUNCTION 


h (Note 1) 




PFK 31 


SOH, j, CR 


FUNCTION 


j (Note 1) 




PFK 32 


SOH, k, CR 


FUNCTION 


k (Note 1) 




PFK 33 


SOH, 1, CR 


FUNCTION 


1 (Note 1) 




PFK Ik 


SOH, SEMI, CR 


FUNCTION 






PFK 35 


SOH, COLON, CR or 
SOH, QUOTE, CR 


FUNCTION 
FUNCTION 


: or 




PFK 36 


SOH, RBRACK, CR or 


FUNCTION 


] or 






SOH, LBRACE, CR or 


FUNCTION 


{ or 






SOH, RBRACE, CR 


FUNCTION 


} 




(Note 1) This char 


acter may be typed in as 


uppercase 


or lowercase 


character . 



Figure B-17 (Part 2 of 2). Program Function Keys for the Lear Siegler ADM-31 
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B.10.3 Setup Functions 



The setup functions are introduced by pressing 

ESC, "ACCENT" (pressed sequentially) 

and then pressing one additional key, which produces the functions as shown in 
Figure B-18. 



FUNCTION 


ASCI l-CODE 
(-Sequence) 




ADM- 


31 KEY 


Set Column Tab 


ESC 


ACCENT 


HT 


TAB 


(Note 1) 


Delete Column Tab 


ESC 


ACCENT 


DEL 


RUB 




Set left margin 


ESC 


ACCENT 


US 


PAGE 


NEWLINE 


Set home 1 i ne 


ESC 


ACCENT 


RS 


HOME 




Delete all Column Tabs, and reset 


ESC 


ACCENT 


ESC, W 


CHAR 


DELETE 


Home Line and Left Margin 












Improved Null Processing 


ESC 


ACCENT 


N 


N 




3270 Nul 1 Processing 


ESC 


ACCENT 


n 


n 




Zones Mode on 


ESC 


ACCENT 


z 


z 




Zones Mode off 


ESC 


ACCENT 


Z 


Z 




Reverse Enter/Newl ine Keys 


ESC 


ACCENT 


e 


e 




Restore Enter/Newl ine Keys 


ESC 


ACCENT 


E 


E 




Reverse Column and Field Tab Keys 


ESC 


ACCENT 


c 


c 




Restore Column and Field Tab Keys 


ESC 


ACCENT 


C 


C 




Alpha in Numeric-Only Field 


ESC 


ACCENT 


v 


V 




3270 Numeric Fields 


ESC 


ACCENT 


V 


V 




3278 Insert Mode 


ESC 


ACCENT 


i 


i 




3277 Insert Mode 


ESC 


ACCENT 


1 


I 




APL Mode on 


ESC 


ACCENT 


a 


a 




APL Mode off 


ESC 


ACCENT 


A 


A 




ASCI 1 Input in APL Mode 


ESC 


ACCENT 


m 


m 




Alternate Display of Attributes 


ESC 


ACCENT 


d 


d 




Primary Display of Attributes 


ESC 


ACCENT 


D 


D 




Suppress Pacing 


ESC 


ACCENT 


P 


P 




Restore Pacing 


ESC 


ACCENT 


P 


P 




Keyboard initiated Line Drop 


ESC 


ACCENT 


PERIOD 






Return to ENTER TERMINAL TYPE Msg. 


ESC 


ACCENT 


COMMA 


J 




Alternate Keyboard Arrangement 


ESC 


ACCENT 


q 


q 




Primary Keyboard Arrangement 


ESC 


ACCENT 


Q 







(Note l) This key can be found on th 


e ma 


n keypac 


i as wel 1 as o 


n the 




additional numeric keypad on the rig 


ht s 


de of th 


le ADM-31 keyb 


oard. 





Figure B-18. Setup Functions for the Lear Siegler ADM-31 
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B.10.4 Local Reset and Control Functions 



There are six key sequences that are completely processed within the IBM 7171, 
and are not passed to the host. These sequences provide a way of controlling and 
clearing the data transmission to and from the terminal: 



CTRL 


and 


g 


Master Reset 


CTRL 


and 


r 


Character Error Reset 


CTRL 


and 


t 


Keyboard Unlock 


CTRL 


and 


X 


Type-ahead Purge 


CTRL 


and 


s 


Pacing Start 


CTRL 


and 


q 


Pacing Stop 



B.10.5 Installation Hints 



Use the EIA RS-232-C Interface in full duplex mode. There should be 7 data bits, 
1 stop bit and 1 parity bit testing on even parity (See Note). 

To set the proper baud rate there are two 16-position reels located on the rear side 
oftheADM-31. 

Select one of the following baud rates for "Modem" and "Printer": 



Reel 














Pos. No. 




1 


2 


3 
1 


4 



BAUD RATE 
300 


5 





1 





6 


= 





1 


1 





600 


7 


= 


1 


1 


1 





1200 


10 


= 





1 





1 


2400 


12 


= 








1 


1 


4800 


14 


= 





1 


1 


1 


9600 











Note: Line speed and parity selection must conform with the specifications defined 
in the IBM 7171 Ports Area of memory for the appropriate communication line. 
Refer to section 4.4.2, "Ports Area Layout" on page 4-21. 

For further configuration control switch setting see the manuf acturer-supplied 
User's Reference Manual. 
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B.ll ADM-3 A Terminal 



B. 1 1 . 1 Control and Cursor Movement Keys 



Function 


Corresponding ASCII 


Corresponding ADM-3A 




Code 


Character Seq. 


Key Sequence Required 


Enter 


CR 




RETURN 


Clear 


SUB 




CTRL and z 


Test Request 


- 




- 


Local Print 


— 




— 


DUP Character 


- 




- 


Fieldmark Character 


- 




- 


Cursor Select 


- 




- 


Redisplay 


SYN 




CTRL and v 


Erase Input 


— 




— 


Erase EOF 


DLE 




CTRL and p 


Delete Character 


DEL 




RUB 


Toggle Insert Mode 


EM 




CTRL and y 


Field Tab 


HT 




CTRL and i 


Field Backtab 


SI 




CTRL and o 


Column Tab 


ESC, 


HT 


ESC, CTRL and i 


Column Backtab 


ESC, 


SI 


ESC, CTRL and o 


1 ndent 


ESC, 


BS 


ESC, CTRL and h 


Undent 


ESC, 


FF 


ESC, CTRL and 1 


PA1 


ESC, 


COMMA or 


ESC, , or 




ESC, 


LESS 


ESC, < 


PA2 


ESC, 


PERIOD or 


ESC, . or 




ESC, 


GREATER 


ESC, > 


PA3 


ESC, 


SLASH or 


ESC, / or 




ESC, 


QUESTION 


ESC, ? 


Newl ine 


NAK 




CTRL and 5 


Home 


RS 




CTRL and * 


Cursor Up 


VT 




CTRL and k or 
CTRL and + 


Cursor Down 


LF 




CTRL and j or 
CTRL and * or 














LINE FEED 


Cursor Right 


FF 




CTRL and 1 or 
CTRL and , 


Cursor Left 


BS 




CTRL and h or 
CTRL and ( 



Figure B-19. Control and Cursor Movement Keys for the Lear Siegler ADM-3 A 
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B.11.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 
(-Sequence) 


ADM-3A KEY 




PFK 1 


ESC, 1 


ESC, 1 




PFK 2 


ESC 


, 2 


ESC 


, 2 




PFK 3 


ESC 


, 3 


ESC 


3 




PFK k 


ESC 


, k 


ESC 


k 




PFK 5 


ESC 


5 


ESC 


5 




PFK 6 


ESC 


> 6 


ESC 


> 6 




PFK 7 


ESC 


, 7 


ESC 


, 7 




PFK 8 


ESC 


, 8 


ESC 


8 




PFK 9 


ESC 


, 9 


ESC 


9 




PFK 10 


ESC 


. 


ESC 







PFK 11 


ESC 


HYPHEN 


ESC 


— 




PFK 12 


ESC 


EQUAL 


ESC 


= 




PFK 13 


ESC 


EXCLAIM or 


ESC 


! or 






ESC 


q 


ESC 


q (Note 1 




PFK 14 


ESC 


AT or 


ESC 


§ or 






ESC 


w 


ESC 


w (Note 1 




PFK 15 


ESC 


POUND or 


ESC 


# or 






ESC 


e 


ESC 


e (Note 1 




PFK 16 


ESC 


DOLLAR or 


ESC 


$ or 






ESC 


r 


ESC 


r (Note 1 




PFK 17 


ESC 


PERCENT or 


ESC 


% or 






ESC 


t 


ESC 


t (Note 1 




PFK 18 


ESC 


UPARROW or 


ESC 


or 






ESC 


y 


ESC 


y (Note 1 




PFK 19 


ESC 


AND or 


ESC 


6 or 






ESC 


u 


ESC 


u (Note 1 




PFK 20 


ESC 


STAR or 


ESC 


or 






ESC 


i 


ESC 


i (Note 1 




PFK 21 


ESC 


LPAREN or 


ESC 


( or 






ESC 


o 


ESC 


o (Note 1 




PFK 22 


ESC 


RPAREN or 


ESC 


) or 






ESC 


P 


ESC 


p (Note 1 




PFK 23 


ESC 


LBRACK or 


ESC 


[or 






ESC 


RBRACK or 


ESC, 


] or 






ESC 


UNDER 


ESC, 






PFK 2k 


ESC 


BSLASH or 


ESC, 


\ or 






ESC 


BAR or 


ESC 


'. or 






ESC 


PLUS 


ESC 


+ 




PFK 25 


ESC 


a 


ESC 


a (Note 1 




PFK 26 


ESC 


s 


ESC 


s (Note 1 




PFK 27 


ESC 


d 


ESC 


d (Note 1 




PFK 28 


ESC 


f 


ESC, 


f (Note 1 




PFK 29 


ESC 


g 


ESC, 


g (Note 1 




PFK 30 


ESC 


h 


ESC, 


h (Note 1 




PFK 31 


ESC 


j 


ESC, 


j (Note 1 




PFK 32 


ESC 


k 


ESC, 


k (Note 1 




PFK 33 


ESC, 


1 


ESC, 


1 (Note 1 




PFK Ik 


ESC 


SEMI 


ESC 


» 




PFK 35 


ESC 


QUOTE 


ESC 


i 




PFK 36 


ESC 


LBRACE or 


ESC 


{ or 






ESC 


RBRACE 


ESC 


} 




(Note 1) This char 


acter may be typed in as 


uppercase or lo\ 


rfercase character. 



Figure B-20. Program Function Keys on the Lear Siegler ADM-3A 
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B. 1 1 .3 Setup Functions 



The setup functions are introduced by pressing 

ESC, "ACCENT" (pressed sequentially) 

and then pressing one additional key, which produces the functions as shown in 
Figure B-21. 



FUNCTION 


ASCI l-CODE 
(-Sequence) 




ADM-3A 


KEY 


Set Column Tab 


ESC, ACCENT 


HT 


CTRL and i 


Delete Column Tab 


ESC 


ACCENT 


DEL 


RUB 




Set left margin 


ESC 


ACCENT 


NAK 


CTRL and 5 


Set home 1 i ne 


ESC 


ACCENT 


RS 


CTRL and A 


Delete all Column Tabs, and reset 


ESC 


ACCENT 


SUB 


CTRL and z 


Home Line and Left Margin 












Improved Null Processing 


ESC 


ACCENT 


N 


N 




3270 Nul 1 Processing 


ESC 


ACCENT 


n 


n 




Zones Mode on 


ESC 


ACCENT 


z 


z 




Zones Mode off 


ESC 


ACCENT 


Z 


Z 




Reverse Enter/Newl ine Keys 


ESC 


ACCENT 


e 


e 




Restore Enter/Newl ine Keys 


ESC 


ACCENT 


E 


E 




Reverse Column and Field Tab Keys 


ESC 


ACCENT 


c 


c 




Restore Column and Field Tab Keys 


ESC 


ACCENT 


C 


C 




Alpha in Numeric-Only Field 


ESC 


ACCENT 


V 


V 




3270 Numeric Fields 


ESC 


ACCENT 


V 


V 




3278 Insert Mode 


ESC 


ACCENT 


i 


i 




3277 Insert Mode 


ESC 


ACCENT 


1 


1 




APL Mode on 


ESC 


ACCENT 


a 


a 




APL Mode off 


ESC 


ACCENT 


A 


A 




ASCI 1 Input in APL Mode 


ESC 


ACCENT 


m 


m 




Alternate Display of Attributes 


ESC 


ACCENT 


d 


d 




Primary Display of Attributes 


ESC 


ACCENT 


D 


D 




Suppress Pacing 


ESC 


ACCENT 


P 


P 




Restore Pacing 


ESC 


ACCENT 


P 


P 




Keyboard initiated Line Drop 


ESC 


, ACCENT 


PERIOD 






Return to ENTER TERMINAL TYPE Msg. 


ESC 


ACCENT 


COMMA 


9 




Alternate Keyboard Arrangement 


ESC 


ACCENT 


q 


q 




Primary Keyboard Arrangement 


ESC 


, ACCENT 





o. 





Figure B-21. Setup Functions for the Lear Siegler ADM-3A 
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B.11.4 Local Reset and Control Functions 



There are six key sequences that are completely processed within the IBM 7171, 
and are not passed to the host. These sequences provide a way of controlling and 
clearing the data transmission to and from the terminal: 



CTRL 


and 


<3 


Master Reset 


CTRL 


and 


r 


Character Error Reset 


CTRL 


and 


t 


Keyboard Unlock 


CTRL 


and 


X 


Type-ahead Purge 


CTRL 


and 


s 


Pacing Start 


CTRL 


and 


q 


Pacing Stop 



B. 1 1 .5 Installation Hints 



Use the EIA RS-232-C Interface in full duplex mode. There should be 7 data bits, 
1 stop bit and 1 parity bit testing on even parity. The baud rate should be one of 
the following: 300, 600, 1200, 2400, 4800, 9600 or 19200. 

Note: Line speed and parity selection must conform with the specifications defined 
in the IBM 7171 Ports Area of memory for the appropriate communication line. 
Refer to section 4.4.2, "Ports Area Layout" on page 4-21. 
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B.12 VT-100 Terminal 



B.12.1 Control and Cursor Movement Keys 



Funct ion 


Corresponding ASCII 


Corresponding VT-100 




Code 


Character Seq. 


Key Sequence Required 


Enter 


CR 




RETURN 


C lear 


ESC, 


0, M 


ENTER (Note 1) 


Test Request 


- 




- 


Local Print 


— 




— 


DUP Character 


— 




- 


Fieldmark Character 


- 




- 


Cursor Select 


- 




- 


Redisplay 


SYN 




CTRL and v 


Erase Input 


— 




— 


Erase EOF 


ESC, 


DEL 


ESC, DELETE 


Delete Character 


DEL 




DELETE 


Toggle Insert Mode 


ESC, 


0, n 


. (PERIOD) (Note 1) 


Column Tab 


ESC, 


ESC, 0, C 


ESC, -»- 


Column Backtab 


ESC, 


ESC, 0, D 


ESC, «- 


Field Tab 


HT 




TAB 


Field Backtab 


ESC, 


HT 


ESC, TAB 


1 ndent 


ESC, 


ESC, 0, A 


ESC, + 


Undent 


ESC, 


ESC, 0, B 


ESC, + 


PA1 


ESC, 


COMMA or 


ESC, , or 




ESC, 


LESS or 


ESC, < or 




ESC, 


0, S 


PF4 


PA2 


ESC, 


PERIOD or 


ESC, . or 




ESC, 


GREATER or 


ESC, > or 




ESC, 


0, m 


- (HYPHEN) (Note 1) 


PA3 


ESC, 


SLASH or 


ESC, / or 




ESC, 


QUESTION or 


ESC, ? or 




ESC, 


0, 1 


, (COMMA) (Note 1) 


Newl ine 


LF 




LINE FEED 


Home 


BS 




BACKSPACE 


Cursor Up 


ESC, 


0, A 


+ 


Cursor Down 


ESC, 


0, B 


+ 


Cursor Right 


ESC, 


0, C 


->■ 


Cursor Left 


ESC, 


0, D 


-«- 


(Note 1 ) This key can 


be found ONLY on the ad 


ditional numeric keypad 


on the right side of t 


he VT- 


-100 keyboard. 




Do not select a simila 


r key 


on the main keypa 


d! 



Figure B-22. Control and Cursor Movement Keys for the VT-100 
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B.12.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 
(—Sequence) 


VT-100 KEY 


PFK 1 


ESC, 1 or 


ESC, 1 (Note 2) or 




ESC 


0, P 


PF1 


PFK 2 


ESC 


2 or 


ESC, 2 (Note 2) or 




ESC 


0, Q 


PF2 


PFK 3 


ESC 


3 or 


ESC, 3 (Note 2) or 




ESC 


0, R 


PF3 


PFK k 


ESC 


k or 


ESC, k (Note 2) or 




ESC 


0, w 


7 (Note 1) 


PFK 5 


ESC 


5 or 


ESC, 5 (Note 2) or 




ESC 


0, x 


8 (Note 1) 


PFK 6 


ESC 


6 or 


ESC, 6 (Note 2) or 




ESC 


o, y 


9 (Note 1) 


PFK 7 


ESC 


7 or 


ESC, 7 (Note 2) or 




ESC 


0, t 


k (Note 1) 


PFK 8 


ESC 


8 or 


ESC, 8 (Note 2) or 




ESC 


0, u 


5 (Note 1) 


PFK 9 


ESC 


9 or 


ESC, 9 (Note 2) or 




ESC 


0, v 


6 (Note 1) 


PFK 10 


ESC 


or 


ESC, (Note 2) or 




ESC 


0, q 


1 (Note 1) 


PFK 11 


ESC 


HYPHEN or 


ESC, - (Note 2) or 




ESC 


0, r 


2 (Note 1) 


PFK 12 


ESC 


EQUAL or 


ESC, = or 




ESC 


0, s 


3 (Note 1) 


PFK 13 


ESC 


EXCLAIM or 


ESC, ! or 




ESC 


0, p, ESC, 0, P or 


(Note 1), PF1 or 




ESC 


q 


ESC, q (Note 3) 


PFK 14 


ESC 


AT or 


ESC, % or 




ESC 


0, p, ESC, 0, Q or 


(Note 1), PF2 or 




ESC 


w 


ESC, w (Note 3) 


PFK 15 


ESC 


POUND or 


ESC, # or 




ESC 


0, p, ESC, 0, R or 


(Note 1), PF3 or 




ESC 


e 


ESC, e (Note 3) 


(Note 1) This key 


can be found ONLY on the add 


itional numeric keypad 


on the right side 


of of the VT-100. 




Do not select a si 


milar key on the main keypad 


| 


(Note 2) This key 


can be found ONLY on the mai 


n keypad. 


Do not select a si 


milar key on the additional 


numeric keypad on 


the right side of 


the VT-100 keyboard! 




(Note 3) This char 


acter may be typed in as upp 


ercase or lowercase character. 



Figure B-23 (Part 1 of 3). Program Function Keys for the VT-100 
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FUNCTION 


ASCI l-CODE 
(-Sequence) 






VT-100 KEY 


PFK 16 


ESC, DOLLAR or 






ESC, $ or 




ESC 


0, p, ESC, 


o, 


w or 


(Note 1), 7 (Note 1) or 




ESC 


r 






ESC,-r (Note 2) 


PFK 17 


ESC 


PERCENT or 






ESC, % or 




ESC 


0, p, ESC, 


o, 


x or 


(Note 1), 8 (Note 1) or 




ESC 


t 






ESC, t (Note 2) 


PFK 18 


ESC 


UPARROW or 






ESC, * or 




ESC 


0, p, ESC, 


o, 


y or 


(Note 1), 9 (Note 1) or 




ESC 


y 






ESC, y (Note 2) 


PFK 19 


ESC 


AND or 






ESC, & or 




ESC 


0, p, ESC, 


o, 


t or 


(Note 1), k (Note 1) or 




ESC 


u 






ESC, u (Note 2) 


PFK 20 


ESC 


STAR or 






ESC, * or 




ESC 


0, p, ESC, 


o, 


u or 


(Note 1), 5 (Note 1) or 




ESC 


i 






ESC, i (Note 2) 


PFK 21 


ESC 


LPAREN or 






ESC, ( or 




ESC 


0, p, ESC, 


o, 


v or 


(Note 1), 6 (Note 1) or 




ESC 


o 






ESC, o 


PFK 22 


ESC 


RPAREN or 






ESC, ) or 




ESC 


0, p, ESC, 


o, 


q or 


(Note 1), 1 (Note 1) or 




ESC 


P 






ESC, p (#) 


PFK 23 


ESC 


LBRACK or 






ESC, [ or 




ESC 


LBRACE or 






ESC, { or 




ESC 


0, p, ESC, 


o, 


r or 


(Note 1), 2 (Note 1) or 




ESC 


UNDER 






ESC, _ 


PFK 2k 


ESC 


RBRACK or 






ESC, 1 or 
ESC, i or 




ESC 


RBRACE or 








ESC 


0, p, ESC, 


o, 


s or 


(Note 1), 3 (Note 1) or 




ESC 


, BSLASH or 






ESC, \ or 




ESC 


, BAR or 






ESC, | or 




ESC 


PLUS 






ESC, + 


(Note 1) This key 


can be found ONLY on the add 


itional numeric keypad 


on the right side 


of of the VT-100 








Do not select a si 


mi lar key on the 


main keypad 


J 


(Note 2) This char 


acter may be typ 


ad 


in as upp 


ercase or lowercase character. 



Figure B-23 (Part 2 of 3). Program Function Keys for the VT-100 
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FUNCTION 


ASCI l-CODE 
(—Sequence) 




VT-100 KEY 




PFK 25 


ESC, ESC, 0, 


P or 


ESC, PF1 or 






ESC 


a 




ESC 


a (Note 2) 




PFK 26 


ESC 


ESC, 0, 


Q or 


ESC 


PF2 or 






ESC 


s 




ESC 


s (Note 2) 




PFK 27 


ESC 


ESC, 0, 


R or 


ESC 


PF3 or 






ESC 


d 




ESC 


d (Note 2) 




PFK 28 


ESC 


ESC, 0, 


w or 


ESC 


7 (*) or 






ESC 


f 




ESC 


f (Note 2) 




PFK 29 


ESC 


ESC, 0, 


x or 


ESC 


8 (*) or 






ESC 


g 




ESC 


g (Note 2) 




PFK 30 


ESC 


ESC, 0, 


y or 


ESC 


9 (*) or 






ESC 


h 




ESC 


h (Note 2) 




PFK 31 


ESC 


ESC, 0, 


t or 


ESC 


k (*) or 






ESC 


j 




ESC 


j (Note 2) 




PFK 32 


ESC 


ESC, 0, 


u or 


ESC 


5 (*) or 






ESC 


k 




ESC 


k (Note 2) 




PFK 33 


ESC 
ESC 


ESC, 0, 
1 


v or 


ESC 
ESC 


6 (*) or 
1 (Note 2) 




PFK 3^ 


ESC 
ESC 


ESC, 0, 
SEMI 


q or 


ESC 
ESC 


1 (*) or 




PFK 35 


ESC 
ESC 


ESC, 0, 
QUOTE 


r or 


ESC 
ESC 


2 (*) or 
i 




PFK 36 


ESC 


ESC, 0, 


s or 


ESC 


3 (*) or 






ESC 


CR 




ESC 


RETURN 




(Note 1) This key 


can be found 


ONLY on the add 


itional numeric keyp 


ad 


on the right side 


of of the VT- 


■100. 






Do not select a si 


mi lar key on 


the main keypad 


I 




(Note 2) This char 


acter may be 


typed in as upp 


ercase or lowercase 


character. 



Figure B-23 (Part 3 of 3). Program Function Keys for the VT-100 
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B.12.3 Setup Functions 



The setup functions are introduced by pressing 

ESC, "ACCENT" (pressed sequentially) 

and then pressing one additional key, which produces the functions listed in 
Figure B-24. 



FUNCTION 


ASCI l-CODE 
(—Sequence) 




VT-100 KEY 




Set Column Tab 


ESC 


ACCENT 


, HT 


TAB 




Delete Column Tab 


ESC 


, ACCENT 


, DEL 


DELETE 




Set left margin 


ESC 


ACCENT 


, LF 


LINE FEED 




Set home 1 i ne 


ESC 


ACCENT 


, BS 


BACKSPACE 




Delete all Column Tabs, and reset 


ESC 


ACCENT 


ESC, 0, M 


ENTER (Note 


1) 


Home Line and Left Margin 












Improved Null Processing 


ESC 


ACCENT 


N 


N 




3270 Nul 1 Processing 


ESC 


ACCENT 


n 


n 




Zones Mode on 


ESC 


ACCENT 


z 


z 




Zones Mode off 


ESC 


ACCENT 


Z 


Z 




Reverse Enter/Newl ine Keys 


ESC 


ACCENT 


e 


e 




Restore Enter/Newl ine Keys 


ESC 


ACCENT 


E 


E 




Reverse Column and Field Tab Keys 


ESC 


ACCENT 


» c 


c 




Restore Column and Field Tab Keys 


ESC 


ACCENT 


C 


C 




Alpha in Numeric-Only Field 


ESC 


ACCENT 


V 


V 




3270 Numeric Fields 


ESC 


ACCENT 


V 


V 




3278 Insert Mode 


ESC 


ACCENT 


i 


i 




3277 Insert Mode 


ESC 


ACCENT 


1 


I 




APL Mode on 


ESC 


ACCENT 


a 


a 




APL Mode off 


ESC 


ACCENT 


A 


A 




ASCI 1 Input in APL Mode 


ESC 


ACCENT 


m 


m 




Alternate Display of Attributes 


ESC, 


ACCENT 


d 


d 




Primary Display of Attributes 


ESC 


ACCENT 


D 


D 




Suppress Pacing 


ESC, 


ACCENT 


P 


P 




Restore Pacing 


ESC 


ACCENT 


P 


P 




Keyboard initiated Line Drop 


ESC, 


ACCENT 


PERIOD 






Return to ENTER TERMINAL TYPE Msg. 


ESC, 


ACCENT 


COMMA 


> 




Alternate Keyboard Arrangement 


ESC, 


ACCENT 


q 


q 




Primary Keyboard Arrangement 


ESC, 


ACCENT 










(Note 1) This key can be found ONLY 


on tr 


e add it 


onal numeric 


keypad 




on the right side of the VT-100 keyb 


oard. 










Do not select a similar key on the m 


a in k 


.eypad! 









Figure B-24. Setup Functions for the VT-100 
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B.12.4 Local Reset and Control Functions 



There are six key sequences that are completely processed within the IBM 7171, 
and are not passed to the host. These sequences provide a way of controlling and 
clearing the data transmission to and from the terminal: 



CTRL 


and 


g 


Master Reset 


CTRL 


and 


r 


Character Error Reset 


CTRL 


and 


t 


Keyboard Unlock 


CTRL 


and 


X 


Type-ahead Purge 


CTRL 


and 


s 


Pacing Start 


CTRL 


and 


q 


Pacing Stop 



B.12.5 Installation Hints 



Use the EIA RS-232-C Interface in full duplex mode (FDX-A) with 7 data bits, 1 
stop bit and 1 parity bit testing on even parity. The baud rate should be one of the 
following: 300, 600, 1200, 2400, 4800, 9600 or 19200. 

Note: Line speed and parity selection must conform with the specifications defined 
in the IBM 7171 Ports Area of memory for the appropriate communication line. 
Refer to section 4.4.2, "Ports Area Layout" on page 4-21. 

There is a built-in setup procedure to select these items in the VT-100. This proce- 
dure is described in the manufacturer-supplied VT-100 Video Terminal User's 
Guide. 

Note: The VT-100 terminal connected to the IBM 7171 has no ability to switch 
the additional numeric keypad on the right side of the terminal between "Numeric 
Keypad Mode" and "Application Keypad Mode." The numeric keypad is always 
set to "Application Keypad Mode," because all keys on this pad are used for 
special purposes e.g. PA and PF keys. Therefore all digits (0-9), minus (-), 
comma (,) and period (.) symbols may only be typed in with keys on the main 
keypad. 
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B.13 DM-1520 and DM-1521 Terminal 



The following tables apply for - both DM-1520 and DM-1521 terminals. 



B.13.1 Control and Cursor Movement Keys 



Funct ion 


Corresponding ASCII 


Corresponding DM— 1 520/21 




Code Character Seq. 


Key Sequence Required 


Enter 


CR 


RETURN 


Clear 


FF 


CLEAR 


Test Request 


- 


- 


Local Print 


— 


- 


DUP Character 


— 


- 


Fieldmark Character 


- 


- 


Cursor Select 


— 


_ 


Redisplay 


SYN 


CTRL and v 


Erase Input 


— 


— 


Erase EOF 


VT 


ERASE EOS 


Delete Character 


DEL 


DEL 


Toggle Insert Mode 


GS 


ERASE EOL 


Field Tab 


HT or 


TAB or 




ESC, FS 


ESC, + 


Field Backtab 


ESC, HT or 


ESC, TAB or 




ESC, BS 


ESC, -«- 


Column Tab 


SO 


PRINT 


Column Backtab 


ESC, SO 


ESC, PRINT 


1 ndent 


ESC, US 


ESC, + 


Undent 


ESC, LF 


ESC, + 


PA1 


ESC, COMMA or 


ESC, , or 




ESC, LESS 


ESC, < 


PA2 


ESC, PERIOD or 


ESC, . or 




ESC, GREATER 


ESC, > 


PA3 


ESC, SLASH or 


ESC, / or 




ESC, QUESTION 


ESC, ? 


Newl ine 


SI 


PRINT OFF 


Home 


EM 


HOME 


Cursor Up 


US 


+ 


Cursor Down 


LF 


+ 


Cursor Right 


FS 


-*■ 


Cursor Left 


BS 


■*- 



Figure B-25. Control and Cursor Movement Keys for the DM-1520/21 
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B.13.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 
(—Sequence) 


DM-1 520/21 KEY 




PFK 1 


ESC, 1 


ESC, 1 




PFK 2 


ESC 


2 


ESC 


2 




PFK 3 


ESC 


3 


ESC 


3 




PFK 4 


ESC 


4 


ESC 


4 




PFK 5 


ESC 


5 


ESC 


5 




PFK 6 


ESC 


6 


ESC 


6 




PFK 7 


ESC 


7 


ESC 


7 




PFK 8 


ESC 


8 


ESC 


8 




PFK 9 


ESC 


9 


ESC 


9 




PFK 10 


ESC 





ESC 







PFK 11 


ESC 


HYPHEN 


ESC 


— 




PFK 12 


ESC 


EQUAL 


ESC 


= 




PFK 13 


ESC 


EXCLAIM or 


ESC 


! or 






ESC 


q 


ESC 


q (Note 1 




PFK 14 


ESC 


AT or 


ESC 


@ or 






ESC 


w 


ESC 


w (Note 1 




PFK 15 


ESC 


POUND or 


ESC 


# or 






ESC 


e 


ESC 


e (Note 1 




PFK 16 


ESC 


DOLLAR or 


ESC 


$ or 






ESC 


r 


ESC 


r (Note 1 




PFK 17 


ESC 


PERCENT or 


ESC 


% or 






ESC 


t 


ESC 


t (Note 1 




PFK 18 


ESC 


UPARROW or 


ESC 


or 






ESC 


y 


ESC 


y (Note 1 




PFK 19 


ESC 


AND or 


ESC 


6 or 






ESC 


u 


ESC 


u (Note 1 




PFK 20 


ESC 


STAR or 


ESC 


* or 






ESC 


i 


ESC 


i (Note 1 




PFK 21 


ESC 


LPAREN or 


ESC 


( or 






ESC 


o 


ESC 


o (Note 1 




PFK 22 


ESC 


RPAREN or 


ESC 


) or 






ESC 


P 


ESC 


p (Note 1 




PFK 23 


ESC 


LBRACK or 


ESC 


[or 






ESC 


RBRACK or 


ESC 


] or 






ESC 


UNDER 


ESC 






PFK 24 


ESC 


BSLASH or 


ESC 


\ or 






ESC 


BAR or 


ESC 


I or 






ESC 


PLUS 


ESC 


+ 




PFK 25 


ESC 


a 


ESC 


a (Note 1 


) 


PFK 26 


ESC 


s 


ESC 


s (Note 1 


) 


PFK 27 


ESC 


d 


ESC 


d (Note 1 


) 


PFK 28 


ESC 


, f 


ESC 


f (Note 1 


) 


PFK 29 


ESC 


g 


ESC 


g (Note 1 


) 


PFK 30 


ESC 


h 


ESC 


h (Note 1 


) 


PFK 31 


ESC 


j 


ESC 


j (Note 1 


) 


PFK 32 


ESC 


k 


ESC 


k (Note 1 


) 


PFK 33 


ESC 


, 1 


ESC 


1 (Note 1 


) 


PFK 34 


ESC 


SEMI 


ESC 


> 




PFK 35 


ESC 


, QUOTE 


ESC 


■ 




PFK 36 


ESC 


, LBRACE or 


ESC 


{ or 






ESC 


, RBRACE 


ESC 


} 




(Note 1) This char 


acter may be typed in as 


uppercase or lo 


wercase character. 



Figure B-26. Program Function Keys for the DM- 1520/21 
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B.13.3 Setup Functions 



The setup functions are introduced by pressing 

ESC, "ACCENT" (pressed sequentially) 

and then pressing one additional key, which produces the functions listed in 
Figure B-27. 



FUNCTION 


ASCI l-CODE 




DM-1 520/21 




(-Sequence) 




KEY 


Set Column Tab 


ESC 


, ACCENT 


SO or 


PRINT 




ESC 


, ACCENT 


HT 


TAB 


Delete Column Tab 


ESC 


, ACCENT 


, DEL 


DEL 


Set left margin 


ESC 


, ACCENT 


SI 


PRINT OFF 


Set home 1 ine 


ESC 


, ACCENT 


EM 


HOME 


Delete all Column Tabs, and reset 


ESC 


, ACCENT 


, FF 


CLEAR 


Home Line and Left Margin 










Improved Null Processing 


ESC 


, ACCENT 


N 


N 


3270 Nul 1 Processing 


ESC 


ACCENT 


n 


n 


Zones Mode on 


ESC 


ACCENT 


z 


z 


Zones Mode off 


ESC 


ACCENT 


Z 


Z 


Reverse Enter/Newl ine Keys 


ESC 


ACCENT 


e 


e 


Restore Enter/Newl ine Keys 


ESC 


ACCENT 


E 


E 


Reverse Column and Field Tab Keys 


ESC 


ACCENT 


c 


c 


Restore Column and Field Tab Keys 


ESC 


ACCENT 


C 


C 


Alpha in Numeric— Only Field 


ESC 


ACCENT 


V 


V 


3270 Numeric Fields 


ESC 


ACCENT 


V 


V 


3278 Insert Mode 


ESC 


ACCENT 


i 


i 


3277 Insert Mode 


ESC 


ACCENT 


1 


1 


APL Mode on 


ESC 


ACCENT 


a 


a 


APL Mode off 


ESC 


ACCENT 


A 


A 


ASCI 1 Input in APL Mode 


ESC 


ACCENT 


m 


m 


Alternate Display of Attributes 


ESC 


ACCENT 


d 


d 


Primary Display of Attributes 


ESC 


ACCENT 


D 


D 


Suppress Pacing 


ESC 


ACCENT, 


P 


P 


Restore Pacing 


ESC 


ACCENT 


P 


P 


Keyboard initiated Line Drop 


ESC 


ACCENT 


PERIOD 




Return to ENTER TERMINAL TYPE Msg. 


ESC, 


ACCENT, 


COMMA 


9 


Alternate Keyboard Arrangement 


ESC 


ACCENT 


q 


q 


Primary Keyboard Arrangement 


ESC 


ACCENT 


Q 


o_ 



Figure B-27. Setup Functions for the DM-1520/21 
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B.13.4 Local Reset and Control Functions 



There are six key sequences that are completely processed within the IBM 7171, 
and are not passed to the host. These sequences provide a way of controlling and 
clearing the data transmission to and from the terminal: 



CTRL 


and 


g 


Master Reset 


CTRL 


and 


r 


Character Error Reset 


CTRL 


and 


t 


Keyboard Unlock 


CTRL 


and 


X 


Type-ahead Purge 


CTRL 


and 


s 


Pacing Start 


CTRL 


and 


q 


Pacing Stop 



B.13.5 Installation Hints 



Use the EIA RS-232-C Interface in full duplex mode with 7 data bits, 1 stop bit 
and 1 parity bit testing on even parity. The baud rate should be one of the fol- 
lowing: 300, 600, 1200, 2400, 4800, or 9600. 

Note: Line speed and parity selection must conform with the specifications defined 
in the IBM 7171 Ports Area of memory for the appropriate communication line. 
Refer to section 4.4.2, "Ports Area Layout" on page 4-21. 
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B.14 DM-3045 Terminal 



B.14.1 Control and Cursor Movement Keys 



Funct ion 


Corresponding ASCII 


Corresponding DM— 30^5 




Code Character Seq. 


Key Sequence Required 


Enter 


CR 


RETURN 


Clear 


ESC, M 


MR 


Test Request 


- 


- 


Local Print 


- 


- 


DUP Character 


— 


- 


Fieldmark Character 


- 


- 


Cursor Select 


- 


- 


Redisplay 


SYN 


CTRL and v 


Erase Input 


— 


— 


Erase EOF 


ESC, J 


SHIFT and ERASE EOS 


Delete Character 


DEL 


RUB OUT 


Toggle Insert Mode 


ESC, P 


INS CHAR 


Field Tab 


HT or ESC, ESC, C 


TAB or ESC, -»■ 


Field Backtab 


ESC, HT or ESC, BS 


ESC, TAB or ESC, «- 


Column Tab 


ESC, V 


ROLL 


Column Backtab 


ESC, ESC, V or 


ESC, ROLL or 




ESC, W 


SHIFT and ROLL 


1 ndent 


ESC, ESC, A 


ESC, + 


Undent 


ESC, LF 


ESC, + 


PA1 


ESC, COMMA or 


ESC, , or 




ESC, LESS 


ESC, < 


PA2 


ESC, PERIOD or 


ESC, . or 




ESC, GREATER 


ESC, > 


PA3 


ESC, SLASH or 


ESC, / or 




ESC, QUESTION 


ESC, ? 


Newl i ne 


ESC, RBRACK 


PRINT 


Home 


ESC, H 


HOME 


Cursor Up 


ESC, A or ESC, Q 


+ or SHIFT and + 


Cursor Down 


LF or ESC, S 


+ or SHIFT and + 


Cursor Right 


ESC, C or ESC, R 


-»■ or SHIFT and ■> 


Cursor Left 


BS or ESC, B 


•*-or SHIFT and «- 



Figure B-28. Control and Cursor Movement Keys for the DM-3045 
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B.14.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 
(-Sequence) 


DM-3045 KEY 




PFK 1 


ESC, 1 or 


ESC, 1 or 






ESC 


P. CR 


PF1 




PFK 2 


ESC 


2 or 


ESC, 2 or 






ESC 


q, CR 


PF2 




PFK 3 


ESC 


3 or 


ESC, 3 or 






ESC 


r, CR 


PF3 




PFK 4 


ESC 


4 or 


ESC, 4 or 






ESC 


s, CR 


PF4 




PFK 5 


ESC 


5 or 


ESC, 5 or 






ESC 


t, CR 


PF5 




PFK 6 


ESC 


6 or 


ESC, 6 or 






ESC 


u, CR 


PF6 




PFK 7 


ESC 


7 or 


ESC, 7 or 






ESC 


v, CR 


PF7 




PFK 8 


ESC 


8 or 


ESC, 8 or 






ESC 


w, CR 


PF8 




PFK 9 


ESC 


9 or 


ESC, 9 or 






ESC 


x, CR 


PF9 




PFK 10 


ESC 


or 


ESC, or 






ESC 


y, CR 


PF10 




PFK 11 


ESC 


HYPHEN or 


ESC, - or 






ESC 


L, CR 


XMIT LINE, RETURN 




PFK 12 


ESC 


EQUAL or 


ESC, = or 






ESC 


T, CR 


XMIT, RETURN 




PFK 13 


ESC 


EXCLAIM or 


ESC, ! or 






ESC 


ESC, p, CR 


ESC, PF1 




PFK 14 


ESC 


AT or 


ESC, @ or 






ESC 


ESC, q, CR 


ESC, PF2 




PFK 15 


ESC 


POUND or 


ESC, # or 






ESC 


ESC, r, CR or 


ESC, PF3 or 






ESC 


e 


ESC, e (Note 1) 




PFK 16 


ESC 


DOLLAR or 


ESC, $ or 






ESC 


ESC, s, CR 


ESC, PF4 




PFK 17 


ESC 


PERCENT or 


ESC, % or 






ESC 


ESC, t, CR 


ESC, PF5 




PFK 18 


ESC 


UPARROW or 


ESC, * or 






ESC 


ESC, u, CR or 


ESC, PF6 or 






ESC 


Y 


ESC, Y 




(Note 1) This char 


acter may be typed in as 


uppercase or lowercase 


character. 



Figure B-29 (Part 1 of 2). Program Function Keys for the DM-3045 
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FUNCTION 


ASCI l-CODE 
(—Sequence) 


DM-3045 KEY 




PFK 19 


ESC, AND or 


ESC, £ or 






ESC 


, ESC, v, CR or 


ESC 


PF7 or 






ESC 


U 


ESC 


U 




PFK 20 


ESC 


STAR or 


ESC 


* or 






ESC 


, ESC, w, CR or 


ESC 


PF8 or 






ESC 


i 


ESC 


i (Note 1) 




PFK 21 


ESC 


LPAREN or 


ESC 


( or 






ESC 


ESC, x, CR or 


ESC 


PF9 or 






ESC 


» o 


ESC 


o (Note 1) 




PFK 22 


ESC 


RPAREN or 


ESC 


) or 






ESC 


ESC, y, CR 


ESC 


PF10 




PFK 23 


ESC 


, LBRACK or 


ESC 


[or 






ESC 


ESC, L, CR or 


ESC 


XMIT LINE, RETURN 


or 




ESC 


UNDER 


ESC 






PFK 2h 


ESC 


BSLASH or 


ESC 


\ or 






ESC 


, BAR or 


ESC 


I or 






ESC 


ESC, T, CR or 


ESC 


XMIT, RETURN or 






ESC 


PLUS 


ESC 


+ 




PFK 25 


ESC 


a 


ESC 


a 




PFK 26 


ESC 


TILDE 


ESC 


~ 




PFK 27 


ESC 


d 


ESC 


d (Note 1) 




PFK 28 


ESC 


f 


ESC 


f (Note 1) 




PFK 29 


ESC 


g 


ESC 


g (Note 1) 




PFK 30 


ESC 


h 


ESC 


h 




PFK 31 


ESC 


j 


ESC 


j 




PFK 32 


ESC 


k 


ESC 


k (Note 1) 




PFK 33 


ESC 


1 


ESC 


1 




PFK 3k 


ESC 


SEMI 


ESC 


t 




PFK 35 


ESC 


QUOTE 


ESC 


i 




PFK 36 


ESC 


LBRACE 


ESC 


{ 




(Note 1) This char 


acter may be typed in as 


uppercase or lowercase 


character . 



Figure B-29 (Part 2 of 2). Program Function Keys for the DM-3045 
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B.14.3 Setup Functions 



The setup functions are introduced by pressing 

ESC, "ACCENT" (pressed sequentially) 

and then pressing one additional key, which produces the functions listed in 
Figure B-30. 



FUNCTION 


ASCI l-CODE 
(—Sequence) 




DM-3045 KEY 


Set Column Tab 


ESC 


ACCENT, 


HT 


TAB 


Delete Column Tab 


ESC 


ACCENT, 


DEL 


RUB OUT 


Set left margin 


ESC 


ACCENT, 




PRINT 






ESC, RBRACK 




Set home 1 ine 


ESC 


ACCENT, 


ESC, H 


HOME 


Delete all Column Tabs, and reset 


ESC 


ACCENT, 


ESC, M 


MR 


Home Line and Left Margin 










Improved Null Processing 


ESC 


ACCENT, 


N 


N 


3270 Nul 1 Processing 


ESC 


ACCENT, 


n 


n 


Zones Mode on 


ESC 


ACCENT, 


z 


z 


Zones Mode off 


ESC 


ACCENT, 


Z 


Z 


Reverse Enter/Newl ine Keys 


ESC 


ACCENT, 


e 


e 


Restore Enter/Newl ine Keys 


ESC 


ACCENT, 


E 


E 


Reverse Column and Field Tab Keys 


ESC 


ACCENT, 


c 


c 


Restore Column and Field Tab Keys 


ESC 


ACCENT, 


C 


C 


Alpha in Numeric-Only Field 


ESC 


ACCENT, 


V 


V 


3270 Numeric Fields 


ESC 


ACCENT, 


V 


V 


3278 Insert Mode 


ESC 


ACCENT, 


i 


i 


3277 Insert Mode 


ESC 


ACCENT, 


1 


1 


APL Mode on 


ESC 


ACCENT, 


a 


a 


APL Mode off 


ESC 


ACCENT, 


A 


A 


ASCI 1 Input in APL Mode 


ESC 


ACCENT, 


m 


m 


Alternate Display of Attributes 


ESC 


ACCENT, 


d 


d 


Primary Display of Attributes 


ESC 


ACCENT, 


D 


D 


Suppress Pacing 


ESC 


ACCENT, 


P 


P 


Restore Pacing 


ESC 


ACCENT, 


P 


P 


Keyboard initiated Line Drop 


ESC 


ACCENT, 


PERIOD 




Return to ENTER TERMINAL TYPE Msg. 


ESC 


ACCENT, 


COMMA 


> 


Alternate Keyboard Arrangement 


ESC 


ACCENT, 


q 


q 


Primary Keyboard Arrangement 


ESC 


ACCENT, 


Q 


Q 



Figure B-30. Setup Functions for the DM-3045 
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Note: The APL Setup functions may also be initiated by another key sequence: 



APL Mode on 


SO 




CTRL and n 


APL Mode off 


ESC, 


RBRACE 


ESC, " 


ASCII Input in APL Mode 


SI 




CTRL and o 



Do not type the Setup function introducer keys for these functions! 



B.14.4 Local Reset and Control Functions 



There are six key sequences that are completely processed within the IBM 7171, 
and are not passed to the host. These sequences provide a way of controlling and 
clearing the data transmission to and from the terminal: 



CTRL 


and 


g 


Master Reset 


CTRL 


and 


r 


Character Error Reset 


CTRL 


and 


t 


Keyboard Unlock 


CTRL 


and 


X 


Type-ahead Purge 


CTRL 


and 


s 


Pacing Start 


CTRL 


and 


g. 


Pacing Stop 



B.14.5 Installation Hints 



Use the EIA RS-232-C interface in full duplex mode with 7 data bits, 1 stop bit 
and 1 parity bit testing on even parity. The baud rate should be one of the fol- 
lowing: 300, 600, 1200, 2400, 4800, 9600 or 19200 (See Note). 

In detail, the switches located under the screen should be as following: 



Switch 


Position 


Description 


REMOTE 


in 


Remote operating mode 


DUPLEX 


in 


Full duplex mode 


TAPE 


out 


Execute special characters 


ASCII 


in 


Select ASCII characters 


EXT CLOCK 


out 


unused 


EIA 


in 


EIA RS-232-C interface 



To set the appropriate baud rates, do the following: 

1 . Press: SHIFT and ALT MODE 

2. Type: "L xxxx," where xxxx is one of the following baud rates: 300, 600, 
1200, 2400, 4800 or 9600. 

3. Press: RETURN 

Note: Line speed and parity selection must conform with the specifications defined 
in the IBM 7171 Ports Area of memory for the appropriate communication line. 
Refer to section 4.4.2, "Ports Area Layout" on page 4-21. 
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I B.15 IBM 316X Terminal 



I B.15.1 Control and Cursor Movement Keys 



Function 


Corresponding ASCII 


Corresponding IBM 3 1 6X 




Code 


Character Seq. 


Key Sequence Required 


Enter 


CR 




-«-J 




ESC, 


8, CR 


Send 


Clear 


ESC, 


L, CR 


Clear 


Test Request 


ESC, 


!, A, ESC, 


Page, Esc, 


DUP Character 


VT 




Ctrl and k 


Fieldmark Character 


FF 




Ctrl and 1 


Cursor Select 


ESC, 


DQUOTE, A, ESC, K 


Jump, Er Inp 


Redisplay 


SYN 




Ctrl and v 


Erase Input 


ESC, 


K 


Er Inp 


Erase EOF 


ESC, 


1 


Erase EOF 


Delete Character 


DEL 




DEL 




ESC, 


Q 


Delete 


Rubout 


BS 




Backspace 


Toggle Insert Mode 


ESC, 


P, SPACE, BS 


Insert 


Field Tab 


HT 




Tab -*■ 


Field Backtab 


ESC, 


2 


Shift and Tab -*■ or 

«- Tab 


Column Tab 


ESC, 


DQUOTE, A, ESC, C 


Jump, -+■ 


Column Backtab 


ESC, 


DQUOTE, A, ESC, D 


Jump, +■ 


Indent 


ESC, 


DQUOTE, A, ESC, A 


Jump, t 


Undent 


ESC, 


DQUOTE, A, ESC, B 


Jump, +• 


PA1 


ESC, 


! , m, CR 


PA1 


PA2 


ESC, 


!, n, CR 


PA2 


PA3 


ESC, 


!, o, CR 


PA3 


Newl ine 


LF 




CTRL and «-J 


Home 


ESC, 


H 


Home 


Cursor Up 


ESC, 


A 


f 


Cursor Down 


ESC, 


B 


+ 


Cursor Right 


ESC, 


C 


-*■ 


Cursor Left 


ESC, 


D 


■«- 



| Figure B-31. Control and Cursor Movement Keys for the IBM 316X 
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B.15.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 
(—Sequence) 


IBM 316X KEY 


PFK 1 


ESC, a, CR 


F1 


PFK 2 


ESC 


b 


CR 


F2 


PFK 3 


ESC 


c 


CR 


F3 


PFK 4 


ESC 


d 


CR 


F4 


PFK 5 


ESC 


e 


CR 


F5 


PFK 6 


ESC 


f 


CR 


F6 


PFK 7 


ESC 


g 


CR 


F7 


PFK 8 


ESC 


h 


CR 


F8 


PFK 9 


ESC 


i 


CR 


F9 


PFK 10 


ESC 


j 


CR 


F10 


PFK 11 


ESC 


k 


CR 


F11 


PFK 12 


ESC 


1 


CR 


F12 


PFK 13 


ESC 




a, CR 


Shift and F1 


PFK 14 


ESC 




b, CR 


Shift and F2 


PFK 15 


ESC 




c, CR 


Shift and F3 


PFK 16 


ESC 




d, CR 


Shift and F4 


PFK 17 


ESC 




e, CR 


Shift and F5 


PFK 18 


ESC 




f, CR 


Shift and F6 


PFK 19 


ESC 




g, CR 


Shift and F7 


PFK 20 


ESC 




h, CR 


Shift and F8 


PFK 21 


ESC 




i, CR 


Shift and F9 


PFK 22 


ESC 




j, CR 


Shift and F10 


PFK 23 


ESC 




k, CR 


Shift and F11 


PFK 24 


ESC 




1, CR 


Shift and F12 


PFK 25 


ESC 


ESC, a, CR 


ESC, F1 


PFK 26 


ESC 


ESC, b, CR 


ESC, F2 


PFK 27 


ESC 


, ESC, c, CR 


ESC, F3 


PFK 28 


ESC 


ESC, d, CR 


ESC, F4 


PFK 29 


ESC 


, ESC, e, CR 


ESC, F5 


PFK 30 


ESC 


ESC, f, CR 


ESC, F6 


PFK 31 


ESC 


ESC, g, CR 


ESC, F7 


PFK 32 


ESC 


, ESC, h, CR 


ESC, F8 


PFK 33 


ESC 


ESC, i, CR 


ESC, F9 


PFK 34 


ESC 


, ESC, j, CR 


ESC, F10 


PFK 35 


ESC 


, ESC, k, CR 


ESC, F11 


PFK 36 


ESC 


, ESC, 1, CR 


ESC, F12 



Figure B-32. Program Function Keys for the IBM 31 6X 
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B.15.3 Setup Functions 



The setup functions are introduced by pressing Jump and then pressing one addi- 
tional key, which produces the functions listed in Figure B-33. 



FUNCTION 


ASCI l-CODE 






IBM 316X KEY 




(-Se 


quence) 










Set Column Tab 


ESC, 


DQUOTE , 


A, 


HT 


Jump 


-N 


Delete Column Tab 


ESC, 


DQUOTE, 


A, 


DEL 


Jump 


DEL 




ESC, 


DQUOTE, 


A, 


ESC, Q 


Jump 


Delete 


Set Left Margin 


ESC, 


DQUOTE, 


A, 


CR 


Jump 


«-J 


Set Home Line 


ESC, 


DQUOTE, 


A, 


ESC, H 


Jump 


Home 


Delete all Column Tabs, and reset 


ESC, 


DQUOTE , 


A, 


ESC, L, CR 


Jump 


Clear 


Home Line and Left Margin 














Improved Null Processing 


ESC, 


DQUOTE, 


A, 


N 


Jump 


N 


3270 Nul 1 Processing 


ESC, 


DQUOTE, 


A, 


n 


Jump 


n 


Zones Mode on 


ESC, 


DQUOTE, 


A, 


z 


Jump 


z 


Zones Mode off 


ESC, 


DQUOTE , 


A, 


Z 


Jump 


Z 


Reverse Enter/Newl ine Keys 


ESC, 


DQUOTE, 


A, 


e 


Jump 


e 


Restore Enter/Newl i ne Keys 


ESC, 


DQUOTE , 


A, 


E 


Jump 


E 


Reverse Column and Field Tab Keys 


ESC, 


DQUOTE, 


A, 


c 


Jump 


c 


Restore Column and Field Tab Keys 


ESC, 


DQUOTE, 


A, 


C 


Jump 


C 


Alpha in Numeric-Only Field 


ESC, 


DQUOTE, 


A, 


V 


Jump 


V 


3270 Numeric Fields 


ESC, 


DQUOTE, 


A, 


V 


Jump 


V 


3278 Insert Mode 


ESC, 


DQUOTE, 


A, 


i 


Jump 


i 


3277 Insert Mode 


ESC, 


DQUOTE, 


A, 


1 


Jump 


1 


APL Mode on 














APL Mode off 














ASCI 1 Input in APL Mode 














Alternate Display of Attributes 


ESC, 


DQUOTE, 


A, 


d 


Jump 


d 


Primary Display of Attributes 


ESC, 


DQUOTE , 


A, 


D 


Jump 


D 


Suppress Pacing 


ESC, 


DQUOTE, 


A, 


P 


Jump 


P 


Restore Pacing 


ESC, 


DQUOTE , 


A, 


P 


Jump 


P 


Keyboard initiated Line Drop 


ESC, 


DQUOTE, 


A, 


PERIOD 


Jump 


• 


Return to ENTER TERMINAL TYPE Msg. 


ESC, 


DQUOTE, 


A, 


COMMA 


Jump 


1 9 


Alternate Keyboard Arrangement 


ESC, 


DQUOTE , 


A, 


q 


Jump 


q 


Primary Keyboard Arrangement 


ESC, 


DQUOTE, 


A, 


Q 


Jump 


. Q 



Figure B-33. Setup Functions for the IBM 3 1 6X 
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I B.15.4 Local Reset and Control Functions 



There are six key sequences that are completely processed within the IBM 7171, 
and are not passed to the host. These sequences provide a way of controlling and 
clearing the data transmission to and from the terminal: 



Ctrl and g 
Ctrl and r 
Ctrl and t 
Ctrl and x 
Ctrl and s 
Ctrl and q 
Ctrl and w 



Master Reset 

Character Error Reset 

Keyboard Unlock 

Type-ahead Purge 

Pacing Start 

Pacing Stop 

Maintenance Facility Toggle 



B.15.5 Installation Hints 



IBM 3163 



The IBM 3161 and IBM 3163 allow the user to configure the terminal hardware by 
using full screen menus. To access the first menu press SetUp, this is 
Ctrl-SELECT. The highlighted field is the field which may be altered. To change 
the highlighted field press the space bar. Each time the space bar is press the list of 
valid options for that field is scrolled 1 position. 



For the IBM 3163 select the following( starred items, "*" are required selections, 
others may deviate ): 

* 3163 

* ECHO 

* RS-232-C 
PRTS 
9600 
EVEN 

* CR 
1 

7 

100 

500 

Press the Send key to save the configuration. 

Press Select. A line of the terminal operation profile will be presented a line at a 
time on the bottom of the screen. 

For the IBM 3163 select the following parameters: 

. ENTER=RETURN 

. RETURN=FIELD 

. NEWLINE=CR 

. TAB=FIELD 

. LINE WRAP=ON 

Press the SEND key, that will save previous selections and present the next set of 
parameters. 
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IBM 3161 



. AUTO LF=OFF 

. SEND=PAGE 

. SEND NULL=ON 

. INSERT=SPACE 

. TRACE=ALL 

. CRTSAVER=15 

Press the SEND key. 

. SCROLL=JUMP 

. PRINT=PAGE 

• PRINT NULL=ON 

. PRINT EOL=ON 

. ENDLINE= CR-LF 

Press the SEND key then press the Select key. You may now press the -*-- 1 key to 
satisfy autobaud. 



For the IBM 3161 select the following( starred items, "*" are required selections, 
others may deviate ): 

* 3161 

* ECHO 

* RS-232-C 
PRTS 
9600 
EVEN 

* CR 
1 

7 

100 

500 

Press the Send key to save the hardware configuration. 

Press Select. A line of terminal operation profile will be presented a line at a time 
on the bottom of the screen. 

For the IBM 3161 select the following parameters: 

. ENTER=RETURN 

. RETURN=FIELD 

. NEWLINE=CR 

. TAB=FIELD 

. LINE WRAP=ON 

Press the SEND key, that will save these selections and present the next set of 
parameters. 
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. AUTO LF=OFF 

• SEND=PAGE 

. SEND NULL=ON 

• INSERT=SPACE 
. TRACE=ALL 

• CRTSAVER=15 

Press the SEND key. 

. SCROLL=ON 

• PRINT=PAGE 

. PRINT NULL=ON 

• PRINT EOL=ON 

• ENDLINE= CR-LF 

Press the SEND key then press the Select key. You may now press the -*- J key to 
satisfy autobaud. 
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B.16 ROLM 3270 Terminal 



I B.16.1 Control and Cursor Movement Keys 



Funct ion 


Corresponding ASC 1 1 


Corresponding ROLM 




Code 


Character Seq. 


Key Sequence Required 


Enter 


CR 




ENTER 


Clear 


SUB 




CLEAR 


Test Request 


RS 




CTRL-RETURN 




ESC, 


ESC, CR 


CTRL-Z 


DUP Character 


ESC, 


D 


ESC, D 




ESC, 


d 


ESC, d 


Fieldmark Character 


ESC, 


F 


ESC, F 




ESC, 


f 


ESC, f 


Cursor Select 


SOH 




CTRL-S 


Redisplay 


ESC, 


V 


ESC, V 




ESC, 


V 


ESC, v 


Erase Input 


ESC, 


X 


ESC, X 




ESC, 


X 


ESC, x 


Erase EOF 


ETX 




DELETE FIELD 


Delete Character 


EOT 




DELETE CHAR 


Toggle Insert Mode 


ACK 




INSERT 


Field Tab 


HT 




TAB 


Field Backtab 


STX 




CONTROL-TAB 


Column Tab 


ESC, 


HT 


ESC, TAB 


Column Backtab 


ESC, 


STX 


ESC, CONTROL-TAB 


Indent 


ESC, 


ESC, ; 


CONTROL-; 


Undent 


ESC, 


ESC, : 


ESC, ESC, : 


PA1 


DCA 




CONTROL-J 


PA2 


EM 




CONTROL-K 


PA3 


NAK 




CONTROL-L 


Newl ine 


BEL 




RETURN 


Home 


SO 




CONTROL-H 


Cursor Up 


VT 




+ 


Cursor Down 


LF 




+ 


Cursor Right 


FF 




■+■ 


Cursor Left 


BS 




-«- 



Figure B-34. Control and Cursor Movement Keys for the ROLM 3270-CYPRESS 
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Funct ion 


Corresponding ASCII 


Corresponding ROLM 






Code Character Seq. 


Key Sequence Requir 


ed 


Enter 


CR 


ENTER 




Clear 


SUB 


CLEAR 




Test Request 


RS 


CTRL-RETURN 






ESC, ESC, CR 


CTRL-Z 




DUP Character 


ESC, D 


ESC, D 






ESC, d 


ESC, d 




Fieldmark Character 


ESC, F 


ESC, F 






ESC, f 


ESC, f 




Cursor Select 


SOH 


CTRL-S 




Redisplay 


ESC, V 


ESC, V 






ESC, v 


ESC, v 




Erase Input 


ESC, X 


ESC, X 






ESC, x 


ESC, x 




Erase EOF 


ETX 


ERASE EOF 




Delete Character 


EOT 


DEL 




Toggle Insert Mode 


ACK 


INS 




Field Tab 


HT 


TAB 




Field Backtab 


STX 


SHIFT-TAB 




Column Tab 


ESC, HT 


ESC, TAB 




Column Backtab 


ESC, STX 


ESC, SHIFT-TAB 




1 ndent 


ESC, ESC, ; 


CONTROL-; 




Undent 


ESC, ESC, : 


ESC, ESC, : 




PA1 


DC4 


CONTROL-J 




PA2 


EM 


CONTROL-K 




PA3 


NAK 


CONTROL-L 




Newl ine 


BEL 


RETURN 




Home 


SO 


HOME 




Cursor Up 


VT 


+ 




Cursor Down 


LF 


+ 




Cursor Right 


FF 


■+ 




Cursor Left 


BS 


■4- 





| Figure B-35. Control and Cursor Movement Keys for the ROLM 3270-CEDAR 
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Function 


Corresponding ASCI 1 


Corresponding ROLM 




Code Character Seq. 


Key Sequence Required 


Enter 


CR 


ENTER 


Clear 


SUB 


CLEAR 


Test Request 


RS 


CTRL-RETURN 




ESC, ESC, CR 


CTRL-Z 


DUP Character 


ESC, D 


ESC, D 




ESC, d 


ESC, d 


Fieldmark Character 


ESC, F 


ESC, F 




ESC, f 


ESC, f 


Cursor Select 


SOH 


CTRL-S 


Redi splay 


ESC, V 


ESC, V 




ESC, v 


ESC, v 


Erase Input 


ESC, X 


ESC, X 




ESC, x 


ESC, x 


Erase EOF 


ETX 


CONTROL-END 


Delete Character 


EOT 


DEL 


Toggle Insert Mode 


ACK 


INS 


Field Tab 


HT 


TAB 


Field Backtab 


STX 


SHIFT-TAB 


Column Tab 


ESC, HT 


ESC, TAB 


Column Backtab 


ESC, STX 


ESC, SHIFT-TAB 


1 ndent 


ESC, ESC, ; 


CONTROL-; 


Undent 


ESC, ESC, : 


ESC, ESC, : 


PA1 


DC4 


CONTROL-J 


PA2 


EM 


CONTROL-K 


PA3 


NAK 


CONTROL-L 


Newl ine 


BEL 


SHIFT-ENTER 


Home 


SO 


HOME 


Cursor Up 


VT 


+ 


Cursor Down 


LF 


+ 


Cursor Right 


FF 


->- 


Cursor Left 


BS 


-*- 



| Figure B-36. Control and Cursor Movement Keys for the ROLM 3270-JUNIPER 
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B.16.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 
(-Sequence) 


ROLM 3270 KEY 


PFK 1 


ESC, ESC, 1 


C0NTR0L-1 


PFK 2 


ESC 


ESC 


2 


C0NTR0L-2 


PFK 3 


ESC 


ESC 


3 


C0NTR0L-3 


PFK k 


ESC 


ESC 


k 


CONTROL-** 


PFK 5 


ESC 


ESC 


5 


CONTROL-5 


PFK 6 


ESC 


ESC 


6 


CONTROL-6 


PFK 7 


ESC 


ESC 


7 


CONTROL-7 


PFK 8 


ESC 


ESC 


8 


CONTROL-8 


PFK 9 


ESC 


ESC 


9 


CONTROL-9 


PFK 10 


ESC 


ESC 





CONTROL-0 


PFK 11 


ESC 


ESC 





CONTROL— 


PFK 12 


ESC 


ESC 


W 


CONTROL-= 


PFK 13 


ESC 


ESC 


E 


CONTROL-Q 


PFK ]k 


ESC 


ESC 


R 


CONTROL-W 


PFK 15 


ESC 


ESC 


T 


CONTROL-E 


PFK 16 


ESC 


ESC 


Y 


CONTROL-R 


PFK 17 


ESC 


ESC 


U 


CONTROL-T 


PFK 18 


ESC 


ESC 


1 


CONTROL-Y 


PFK 19 


ESC 


ESC 





CONTROL-U 


PFK 20 


ESC 


ESC 


P 


CONTROL-I 


PFK 21 


ESC 


ESC 


A 


CONTROL-0 


PFK 22 


ESC 


ESC 


S 


CONTROL-P 


PFK 23 


ESC 


ESC 


D 


CONTROL-[ 


PFK Ik 


ESC 


ESC 


F 


CONTROL-] 


PFK 25 


ESC 


ESC 


G 


ESC, ESC, G 


PFK 26 


ESC 


ESC 


H 


ESC, ESC, H 


PFK 27 


ESC 


ESC 


J 


ESC, ESC, J 


PFK 28 


ESC 


ESC 


K 


ESC, ESC, K 


PFK 29 


ESC 


ESC 


L 


ESC, ESC, L 


PFK 30 


ESC 


ESC 


Z 


ESC, ESC, Z 


PFK 31 


ESC 


ESC 


X 


ESC, ESC, X 


PFK 32 


ESC 


ESC 


c 


ESC, ESC, C 


PFK 33 


ESC 


ESC 


V 


ESC, ESC, V 


PFK Ik 


ESC 


ESC 


N 


ESC, ESC, N 


PFK 35 


ESC 


ESC 


M 


ESC, ESC, M 


PFK 36 


ESC 


ESC 


COMMA 


ESC, ESC, , 



| Figure B-37. Program Function Keys for the ROLM 3270 
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B.16.3 Setup Functions 



The setup functions are introduced by pressing ESC ACCENT and then pressing 
one additional key, which produces the functions listed in Figure B-38. 



FUNCTION 


ASCI l-COD 




ROLM 


3270 KEY 




(-Sequence) 










Set Column Tab 


ESC, 


ACCENT, 


HT 


ESC, 


ACCENT, 


TAB 


Delete Column Tab 


ESC, 


ACCENT, 


EOT 


ESC, 


ACCENT, 


DEL 


Set Left Margin 


ESC, 


ACCENT, 


NAK 


ESC, 


ACCENT, 


CONTROL-TAB 


Set Home Line 


ESC, 


ACCENT, 


SO 


ESC, 


ACCENT, 


Home 


Delete all Column Tabs, and reset 


ESC, 


ACCENT, 


SUB 


ESC, 


ACCENT, 


Clear 


Home Line and Left Margin 














Improved Null Processing 


ESC, 


ACCENT, 


N 


ESC, 


ACCENT, 


N 


3270 Nul 1 Processing 


ESC, 


ACCENT, 


n 


ESC, 


ACCENT, 


n 


Zones Mode on 


ESC, 


ACCENT, 


z 


ESC, 


ACCENT, 


z 


Zones Mode off 


ESC, 


ACCENT, 


Z 


ESC, 


ACCENT, 


Z 


Reverse Enter/Newl ine Keys 


ESC, 


ACCENT, 


e 


ESC, 


ACCENT, 


e 


Restore Enter/Newl ine Keys 


ESC, 


ACCENT, 


E 


ESC, 


ACCENT, 


E 


Reverse Column and Field Tab Keys 


ESC, 


ACCENT, 


c 


ESC, 


ACCENT, 


c 


Restore Column and Field Tab Keys 


ESC, 


ACCENT, 


C 


ESC, 


ACCENT, 


C 


Alpha in Numeric-Only Field 


ESC, 


ACCENT, 


v 


ESC, 


ACCENT, 


V 


3270 Numeric Fields 


ESC, 


ACCENT, 


V 


ESC, 


ACCENT, 


V 


3278 Insert Mode 


ESC, 


ACCENT, 


i 


ESC, 


ACCENT, 


i 


3277 Insert Mode 


ESC, 


ACCENT, 


1 


ESC, 


ACCENT, 


1 


APL Mode on 














APL Mode off 














ASCI 1 Input in APL Mode 














Alternate Display of Attributes 


ESC, 


ACCENT, 


d 


ESC, 


ACCENT, 


d 


Primary Display of Attributes 


ESC, 


ACCENT, 


D 


ESC, 


ACCENT, 


D 


Suppress Pacing 


ESC, 


ACCENT, 


P 


ESC, 


ACCENT, 


P 


Restore Pacing 


ESC, 


ACCENT, 


P 


ESC, 


ACCENT, 


P 


Keyboard initiated Line Drop 


ESC, 


ACCENT, 


PERIOD 


ESC, 


ACCENT, 




Keyboard initiated Line Drop 


ESC, 


ESC, B 




DISCONNECT 




Return to ENTER TERMINAL TYPE Msg. 


ESC, 


ACCENT, 


COMMA 


ESC, 


ACCENT, 


» 


Alternate Keyboard Arrangement 


ESC, 


ACCENT, 


q 


ESC, 


ACCENT, 


q 


Primary Keyboard Arrangement 


ESC, 


ACCENT, 


Q 


ESC, 


ACCENT, 


Q 



Figure B-38. Setup Functions for the ROLM 3270 
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I B.16.4 Local Reset and Control Functions 



There are six key sequences that are completely processed within the IBM 7171, 
and are not passed to the host. These sequences provide a way of controlling and 
clearing the data transmission to and from the terminal: 



RESET 

Ctrl and V 
RESET 
Ctrl and X 



Ctrl and F 



Master Reset 

Character Error Reset 

Keyboard Unlock 

Type-ahead Purge 

Pacing Start 

Pacing Stop 

Maintenance Facility Toggle 
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B.17 TYPETERM Typewriter Terminal 



TYPETERM denotes a typical ASCII typewriter terminal, without specifying any 
particular brand or model. For this reason column 3 in each of the following tables, 
which normally shows the keys that initiate the function shown in column 1, has 
been left blank. 

When it has been determined which keys on the ASCII terminal generate the 
ASCII code sequence shown in column 2, record them in column 3 for future refer- 
ence. 



B.17.1 Control and Cursor Movement Keys 



Funct ion 


Corresponding ASCII 


Corresponding 




Code Character Seq. 


Key Sequence Required 


Enter 


CR 




Redisplay 


SYN 




Delete Character 


DEL 




Toggle Insert Mode 


ESC, i or 
ESC, 1 




Field Tab 


ESC, t or 
ESC, T 




Field Backtab 


ESC, b or 


(See note at the start 




ESC, B 


of this section) 


Column Tab 


HT 




Column Backtab 


ESC, HT 




PA1 


ESC, COMMA or 
ESC, LESS 




PA2 


ESC, PERIOD or 
ESC, GREATER 




PA3 


ESC, SLASH or 
ESC, QUESTION 




Newl ine 


LF 




Cursor Left 


BS 





Figure B-39. Control and Cursor Movement Keys for a typical ASCII Typewriter Terminal 



B-60 IBM 7171 Reference Manual and Programming Guide 



B.17.2 Program Function Keys 



FUNCTION 


ASCI l-CODE 


Corresponding 




(-Sequence) 


Key Sequence Required 


PFK 1 


ESC, 1 




PFK 2 


ESC 


2 




PFK 3 


ESC 


3 




PFK k 


ESC 


k 




PFK 5 


ESC 


5 




PFK 6 


ESC 


6 




PFK 7 


ESC 


7 




PFK 8 


ESC 


8 




PFK 9 


ESC 


9 




PFK 10 


ESC 







PFK 11 


ESC 


HYPHEN 




PFK 12 


ESC 


EQUAL 




PFK 13 


ESC 


EXCLAIM or 






ESC 


q 




PFK 1J» 


ESC 


AT or 






ESC 


w 




PFK 15 


ESC 


POUND or 


(See note at the start 




ESC 


e 


of this section) 


PFK 16 


ESC 


DOLLAR or 






ESC 


r 




PFK 17 


ESC 


PERCENT 




PFK 18 


ESC 


UPARROW or 






ESC 


u 




PFK 19 


ESC 


AND or 






ESC 


u 




PFK 20 


ESC 


STAR 




PFK 21 


ESC 


LPAREN or 






ESC 


o 




PFK 22 


ESC 


RPAREN or 






ESC 


P 




PFK 23 


ESC 


UNDER or 






ESC 


RBRACK or 






ESC 


LBRACK 




PFK 24 


ESC 


PLUS or 






ESC 


BSLASH or 






ESC 


BAR 




PFK 25 


ESC 


a 




PFK 26 


ESC 


s 




PFK 27 


ESC 


d 




PFK 28 


ESC 


f 




PFK 29 


ESC 


9 




PFK 30 


ESC 


h 


(See note at the start 


PFK 31 


ESC 


J 


of this section) 


PFK 32 


ESC 


k 




PFK 33 


ESC 


1 




PFK Ik 


ESC 


SEMI 




PFK 35 


ESC 


QUOTE 




PFK 36 


ESC 


RBRACE or 






ESC 


LBRACE 





Figure B-40. Program Function Keys for a Typical ASCII Typewriter Terminal 
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Appendix C. IBM 7171 Support Utility for Modifying Terminal Tables 



C.l IBM 7171 Support Utility Introduction 



In order for the the IBM 7171 to communicate with attached ASCII devices, the 
characteristics of each individual device and the line to which the device is attached 
must be defined. If the device type is a native terminal definition, then the user 
must supply the terminal definition. The user will also need to define the line char- 
acteristics for each communication line, port, if the default port configuration is not 
appropriate for the application. The Support Utility has been provided to perform 
these functions. A description of the data structures used in Nonvolitile-RAM, 
NV-RAM can be found in Chapter 4, "Customizing IBM 7171 Tables" on 
page 4-1. 

The Support Utility allows users to: 

1 . Customize device types off line 

2. Specify port configurations off line 

3 . Write blocks of NV-RAM 

4. Copy blocks of NV-RAM 

5. Generate new terminal definition tables off line 

6. Modify existing terminal definition tables off line 

7. Store terminal definition tables on a PC DOS diskette or disk. 
Two different tools are provided for maintaining terminal tables. 

• 7171. COM, which provides : 

— Menu driven editing capability for generating or modifying terminal and 
port tables 

— Reading and writing of Blocks of NV-RAM. 
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7171TML.COM, which provides: 

- Expansion of Terminal Macro Language, TML, macros for generation of 
NV-RAM images 

- Reading and Writing of blocks of NV-RAM. 



C.2 Objectives of the Support Utility 



The Support Utility's Objectives: 

• Help the user create terminal tables. 

• Aid the user in converting existing terminal definition tables into tables the 
IBM 7171 can use. 



C.3 Types of users: 



• Those who are satisfied with the Default tables. These users have do not need 
to use the Support Utility. 

• Those who have needs beyond the Default tables. 

- Which have tables defined, but in an unusable form for the IBM 7171 

- Which don't have tables defined, but have a need for unique terminal defi- 
nition tables. 
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C.4 Support Utility Diskette Contents 



Following is a list of the Support Utilities and data files on the IBM 7171 Support 
Utility diskette: 



File 








Name 




Description 




7171 


.COM 


Main Menu Driver (Screens/Fill in the 


Blanks) 


7171 


.MNU 


Menus for 7171 




7171 PORT 


.EXE 


Ports Configuration Utility 




7171 TERM 


.EXE 


Terminal Editing Utility 




7171EDIT 


.EXE 


Edit Utility for Control File 




7171LINK 


.EXE 


Link Utility 




717110 


.EXE 


Input/Output to the IBM 7171 




7171 TML 


.COM 


Main Menu Driver for TML processing 




7171 TML 


.MNU 


Menus for 71 71 TML 




7171 MLNK 


.EXE 


Link Utility for TML 




7171MPRT 


.EXE 


Ports definitions using Macros 




TST 


.CTL 


Sample Control File for Linking 




TST 


.IMG 






TST 


.TRM 






TSTOBJ 


.RPT 






TSTPORTS 


.RPT 






TSTSRC 


.TML 






TSTTERMS 


.RPT 






ADM31 


.TRM 


Terminal Data Files 




ADM3A 


.TRM 






DM1520 


.TRM 






DM1521 


.TRM 






DM3045 


.TRM 






HARDCOPY 


.TRM 






IBM3101 


.TRM 






PLOTTER 


.TRM 






ROLM1 


.TRM 






TVI912 


.TRM 






TVI920 


.TRM 






TVI950 


.TRM 






TVI950R 


.TRM 






TYPETERM 


.TRM 






VT100 


.TRM 







Figure C-l. Contents of IBM 7171 Support Utility Diskette 



C.5 Support Utilities 



The Support Utility is two utilities which exist in a parallel environment. 



7171.COM is the easiest to use. However, it restricts the number of terminals 
types the user can put into NV-RAM. Typically, 8 to 12 terminal types can be 
defined. The number of terminal types which can be placed in NV-RAM depends 
on the exact data required to define the terminals. 
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When using 7171TML.COM, it is possible to define 30 or more terminals. 
7171TML.COM was provided to help users migrate from the Series/1 environ- 
ment to the IBM 7171 environment. 7171TML does offer more flexibility, 
however it is not as easy to use. If the user needs to define a translate table, 
7171TML.COM is capable of defining translate tables. See item 6 on page 4-30, 
item 5 on page 4-29, Appendix A, "ASCII and EBCDIC Data Conversion 
Tables" on page A- 1, and Appendix D, "Interface for User Supplied Table Mod- 
ification Program" on page D-l for help understanding translate tables. Some 
users may prefer to write their own program for generating image files. 

It is up to each installation to evaluate their needs and skills before selecting which 
utility to use. 

7171.COM provides menu driven screens and interactive messages, which point 
out contradicting data and warns the user when potentially erroneous data has been 
entered. The 7171 utility is organized into logically related functions. 



Utility 

7171.COM 



Function 

The utility starts the resident portion of the Menu Driven 
Utility. 



7171.MNU 



The utility which calls other sub utilities, and manages the 
main menu. 



7171PORT.EXE 
7171TERM.EXE 



The sub utility for configuring PORTS. 

The sub utility for editing and defining data for a specific 
terminal definition. 



7171LINK.EXE 



The sub utility which assembles one or more terminal defi- 
nitions into a hexadecimal ASCII image of the 8K 
N V-RAM of the IBM 7171. 



7171IO.EXE The functional code which transfers a hexadecimal ASCII 

image between the IBM 7171 and PC-DOS files. 



7171TML.COM 



The resident utility which starts the screen driven portion of 
TML. 



7171TML.MNU 



The utility which calls other sub utilities, and manages the 
main menu. 



7171MLNK.EXE 



The sub utility which assembles one or more terminal defi- 
nitions from TML form into a hexadecimal ASCII image of 
the 8K NV-RAM for the IBM 7171. 



7171MPRT.EXE 



The sub utility which assembles one or more port definitions 
from the PORT macro into a hexadecimal ASCII image of 
the 8K NV-RAM for the IBM 7171. This utility is compat- 
ible with 7171LINK and 7171MLNK. 
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C.6 User Support Utilities 



Some users may have needs which extend beyond the scope of the Support Utilities 
provided. In particular, a user may need to define a large number of terminals. If 
this is the case, a utility for assembling and optimizing the data may be worth the 
time spent developing the code. 



C.7 File Extensions 



The following file extension naming conventions are used with the 7171.COM 
utility. 

EXTENSION FILE CONTENTS 

.TRM This file extension results from 7171TERM being run. Files with this 

extension contain terminal specific data which can be LINKed into a 
hexadecimal ASCII file. 

.CTL This file extension is used for files which contain information used as 

input to the 7171LINK utility. .CTL files contain the name of native, 
or ROM, terminal types, as well as the file names of user defined ter- 
minal tables, .TRM files. 

.IMG .IMG files contain ASCII characters from the set of hexadecimal char- 

acters which represent an image, or picture of NV-RAM. 

.TML .TML files contain source code for 7 17 1MLNK which assembles 

macros into .IMG files. 

.PRO .PRO files contain source code for 7171MPRT which assembles port 

macros into existing .IMG files. 



C.7.1 .TRM Files 



.TRM files contain the following data: 

The terminal name which may appear after the VALID TYPES ARE message. 

Terminal header information such as, flags, cursor origin, and output delay. 

Reset characters. 

Graphics Rendition Control String (GRCS). 

The terminal's physical screen size. 

The screen size of the terminal being emulated (ie 3278 Model 5). 

Output control sequence strings (CSS). 

Terminal initialization sequence. 

The input parse table. 



The user may select a .TRM file supplied on the Support Utility Diskette or create 
one by selecting TERMS on the 7171.COM's main menu and then editing the new 
file, or loading the existing .TRM file and then editing that data, followed by a 
save. 
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C.7.2 .CTL files 



.CTL files contain the following data: 

• The names of ROM, or native terminal definitions to be included in an .IMG 
file. 

• The names of the user modified or created .TRM files. 

• Assembler directives for controlling how the terminal names message shall 
appear. 

Use Edit - .CTL or your favorite text editor to generate .CTL files. 

Here is an example of a .CTL file: 

EXAMPLE1.CTL 

7171:IBM3101,- 
7171: TYPETERM 

This .CTL file will be an input file for 7171LINK. From the information present, 
the LINK utility can build the list of terminal names which will appear after the 
VALID TYPES ARE message, and the Terminal Definition Tables, TDTs, needed 
to interface the IBM 7171. 

The Prefix "7171:" tells the LINK utility that this is a definition of a native ter- 
minal type (stored in ROM). 

The "-" which follows IBM3101, tells the LINK utility that any terminals named 
after this point should be hidden from the VALID TYPES ARE: message. 

Note: These types will still be valid, they are only omitted from the message. 

Here is a second example of a .CTL file: 

EXAMPLE2.CTL 

7171 :IBM3101 , IBMALTER.TRM,+ 

A:IBMPC.TRM, 

7171 : TYPETERM, - 

7171: HARDCOPY , % 

VT100.TRM 

Example2.CTL will tell 7171LINK that the native terminal types of IBM3101, 
HARDCOPY, and TYPETERM will be included in the definitions. It also tells 
7171LINK that on the default drive there is a .TRM file named IBMALTER which 
has a terminal definition, and on the A drive there is a .TRM file named IBMPC 
which should also be included in the assembling. 

The "+" following IBMALTER.TRM marks the beginning of a new line of the ter- 
minal names list. 

The "%" tells 7171LINK to start a new sublist. Sublists are used to separate ter- 
minals which will support different 3270 Model groups. For instance, the VT100 
can be made to look like a 3278 Model 5. 
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ENTER TERMINAL TYPE: 
VALID TYPES ARE: 
IBM3101, IBMALTER 
IBMPC, TYPETERM 



In summary, here is the syntax of a .CTL file: 



7171 mativeterminal 



For defining native or ROM terminal types, 
nativeterminal should be substituted with the name 
of the terminal, A list of this names can be found in 
Appendix B, "IBM 7171 Supplied Terminal Defi- 
nition Tables" on page B-l. 



[x:]filename.trm 



For defining user generated terminal types, 
filename, trm should be a DOS filename selected by 
the user. 



+ 



For starting a new line in the VALID TYPES ARE 
MESSAGE. 



For hiding terminal names 



% 



For starting a new sublist within a terminal names 
list, from the VALID TYPES ARE MESSAGE. 



C.7.3 .IMGfOes 



.IMG files contain ASCII characters which make up a hexadecimal image of 
NV-RAM. These files may contain ports data, terminal data, or both ports and 
terminal data. The next available byte's address is found at DC00:0002, Ports data 
can be found beginning at DC00:0010, and Terminal data can be found beginning 
at DC00:0300. An image file will always have the next available byte's address, 
then either Ports data, or Terminal data, or both Ports and Terminal data. The 
ORG= determines where the data corresponds to NV-RAM. Remember an image 
file is a partial byte by byte representation of NV-RAM. Here is the file format: 



ORG=startpoint1 

hexadecimal character string 



hexadecimal character string 

0RG=startpoint2 

hexadecimal character string 



hexadecimal character string 



) 
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Here is an abbreviated example: 



ORG=0000 
00209A03 
ORG=0300 

41444D3331202020068041444D33412020200780FFFF44D3 

44D31 35323 120200A80444D3330343520200B80FFFF49424D333 1303 12 
FFFF5445535 



C.7.4 .TMLfOes 



C.7.5 .PRO files 



The ORG= is in the .IMG file so the 7171IO utility knows where to put the data in 
NV-RAM (segment DC00:xxxx). The hexadecimal strings which follow is the data 
to be moved. 

.IMG files can be created by: 

• 7171LINK, which creates image files that contain terminal definition data that 
has been assembled from .TRM files, as directed by the .CTL file. 

• 7171MLNK, which creates an image file from Terminal Macro Language, 
TML. 

• 7171PORT, which creates an image file that defines the characteristics of the 
communications ports. 

• 7 17 HO get function which creates an image file by copying portions of 
NV-RAM. 

• A User program. 



.TML files contain terminal macro language source files. These files are input to 
7171MLNK which will create a .IMG file. 



.PRO files contain port configuration definitions in the form of macros. This is a 
very efficient way to update the ports area of an image file. 
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C.8 7171.COM Menu Driven Screens 



C.8.1 Advantages 



C.8. 2 Limitations 



7171.COM provides menu driven screens for data entry. The prime advantage is 
the user only needs to fill in the blanks. As the user enters data, the 7171.COM 
verifies that the data entered is consistent with data currently stored (may be 
default values). Even though 7171.COM warns the user of his errors and contra- 
dictions, it doesn't inhibit processing. It will allow the processing to proceed. If the 
user means to have some contradiction of data, 7171.COM will allow it. With 
7171.COM, the user may choose between entering the hexadecimal values of char- 
acters, or the user may enter the actual keystroke if in BINKEY mode. For 
example: 1B=ESC, the user may choose the BINKEY mode, and press the ESC 
key which would input IB which is the hex value for escape. 



7171.COM provides fill-in-the-blank type screens for the user. With 7171.COM 
there will be room for approximately 10 user defined terminals. The actual number 
of tables will vary depending on the size of each terminal definition table defined. 
Also, only the default translate tables may be used, unless a user patches in the 
correct translate table and addresses. 

Here are the calling paths between the various screens. 



7171 










MAIN 
I 


(7171) 




I 
I/O 


I 

PORTS 

I 

I 






IT 


I 
TERMS 
I 
I 
I 
I 
I 
I 
I 
I 




I I 
EDIT.CTL LINK 
I 
I 


I I 
LOAD CONFIG 


I 

SAVE 


I 
REPOI 


I 
LOAD 


I I 
EDIT SAVE 


I 
LOAD 


I I 
EDIT SAVE 


I 

REPORT 



Figure C-2. Calling Tree of IBM 7171 Support Functions 
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C.8.3 Ports Configuration 



PORTS, 7171PORT presents the screens which allow the user to select one from 
several possible activities associated with the PORTS definitions. 

1 . LOAD which brings the image file into memory so the ports maybe configured. 

2. CONFIGURE 

• The communication rate for each Port, Baud, Bits/Second, default = 
autobaud detect. 

• The Flags for each Port, default = x • 1 A00 ' 

• The Terminal Type at line connect time default = none, prompt for ter- 
minal type. 

• The Terminal Names List of Valid terminal types, default=none, use the 
list beginning at X ' 300 ' . 

3. SAVE writes all the image data out to a DOS file. 

4. REPORT generates a form summarizing the Ports configuration. 



C.8.4 Editing Terminal Types 



TERMS, 7171TERM, manages the editing session for an individual terminal defi- 
nition, .TRM files. 

1 . LOAD brings a .TRM file from DOS storage into memory for an edit session. 

2. EDIT allows the user to select a specific terminal data definition for editing. 
Under the TERMS - EDIT screen the user may select to edit any of the 
following: 

• FEATURES ~ Flags, Cursor Origin, Output Delay length. 

• INPUT SEQUENCES ~ the Input Parse Sequences, PF keys, Home, 
Enter, Backspace, etc. 

• OUTPUT SEQUENCES -- Output Control Sequence Strings, CSSs, Repo- 
sition, End of Line, Tone, CSS sequences which may be 16 up to charac- 
ters in long. 

• LOGIN SEQUENCE ~ Terminal Initialize sequence. 

• RESET CHARACTERS ~ Reset Introducer, Master Reset, Pacing, Flush 
Buffers, Etc. 

• GRAPHIC RENDITION CONTROL STRINGS, both primary and alter- 
nate. 

• Alternate Screen Size Definitions, terminal size and 3270 size. 

3. SAVE - writes the .TRM file out to a DOS file. 

4. REPORT ~ generates a form which describes the terminal's input and output 
sequences as well as particular features and characteristics. 
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C.8.5 Editing .CTL fUes 



EDIT .CTL, is an editor for .CTL files. Usage of the user's favorite text editor is 
acceptable. 



C.8.6 Creating Image Files via 7171LINK 



LINK, assembles .TRM files into a hexadecimal ASCII representation of 
NV-RAM by assembling the TDTs specified in the .CTL file. 



C.8.7 Reading and Writing Data to NV-RAM 



I/O, emulates a user logging onto the ZAP interface to read or write data from the 
NV-RAM. The user needs to specify Get or Put of an Image file, Ports or Terms, 
the name of an .IMG file, the ZAP interface password and if COM2 will be used, 
COM1 is default. The user can type the following at the DOS prompt: 

"7171IOPTxxx.IMG" 

which places the xxx terminal image into the NV-RAM and assumes usage of 
COM1 and the initial ZAP password, @@ZAP@@. The 7171IO utility requires 
TYPETERM to be a valid terminal type. 



C.9 7171TML.COM Terminal Macro Language 



C.9.1 Advantages 



7171TML has the ability to expand macros which resemble a "subset" of the 
macros used for defining terminal definition tables on the Series/ 1. This may be a 
quick way to adapt terminal definition tables for IBM 7171. 

.TML files are text files. Using a text editor is appropriate for maintaining and cre- 
ating terminal definitions using macros. Use either DOS EDLIN or the IBM Per- 
sonal Editor. 

Note: To users who use mainframe editors: Make sure the files have a record 
format of variable. 

Each .TML file contains all the data required to build an .IMG file. So, .TML files, 
contain the same data that is found in some combination of .TRM files and a .CTL 
file. of7171.COM 

Here is a trace of 7171TML's calling tree. 
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7171 TML 


MAIN (71 71 TML) 
I 


I 
MPRT 


I 
EDIT. TML 


I 
MLNK 


I 
I/O 



Figure C-3. Calling Tree of IBM 7171TML Support Functions 

C.9.2 Port Definitions 

7171MPRT assembles port definitions and inserts them into an existing image file. 

C.9.3 Editing Terminal Types 

Use DOS EDLIN, the IBM Personal Editor, or your favorite text editor. 
Note: Use variable length file format only. 

C.9.4 Creating Image files via 7171MLNK 

7171MLNK assembles and expands the macros of .TML files into a hexadecimal 
ASCII representation of NV-RAM. 7171MLNK does not optimize memory usage. 
It is up to the user to perform any optimizations desired. 



C.9.5 Reading and Writing Data to NV-RAM 



7 17 HO works the same way as for 7171.COM. See Reading and Writing Data to 
NV-RAM under 7171.COM. 



CIO Installation of the Support Utility 



Following is a list of the minimum required hardware to run the supplied Support 
Utility. 

• A PC system unit with a minimum of 128K memory. Any of the following PC 
family processors are acceptable: IBM PC, IBM PC XT, IBM PC XT/370, 
IBM PORTABLE PC, IBM PC AT. 

• One 320 Kb Diskette Drive. 
. PC-DOS (2.X). 
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• Asynchronous Communications Adapter (RS-232 interface) (300-9600 
Bits/second). 

• One IBM 7171 direct attachment cable or modem cable. 

• IBM 7171 Support Utility diskette. 

Before running the Support Utility, make a copy of the entire diskette, and keep 
the original as a backup. 

Following are the installation instructions: 

1. Connect the IBM 7171 direct attachment cable or modem cable between the 
asynchronous communications port on the PC, and Port of the IBM 7171, if 
the 7 17 HO utility will be used. 

Note: All operations except I/O can be performed without cable attachment. 

2. Turn on IBM PC, and load DOS. 

3. If I/O between the PC and the IBM 7171 will take place, the communications 
port (COM1 or COM2) must be initialized through DOS otherwise continue 
with the next step. The initialization must coincide with the port configuration 
set in the IBM 7171 for port 0. The initial setting is for auto baud detect, Even 
Parity, Seven Data Bits, One Stop Bit. To communicate at 9600 baud the fol- 
lowing DOS command should be issued: 

MODE COM1 : 9600 ,E, 7,1 

4. Insert the copy of IBM 7171 Support Utility diskette into diskette drive then 
issue the 7171 or 7171TML command. 
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C.ll IBM 7171 Support Utility Operation 



There are two methods for using the IBM 7171 Support Utility. These are: 

1. From full-screen Menus 

2. From commands entered directly in DOS. 

These two methods offer a user flexibility in performing support operations. Some 
commands allow functions to be invoked without using the menu. These com- 
mands allow either direct execution from the DOS command line or incorporation 
into DOS BAT files. Two figures Figure C-4 and Figure C-5, show the hierarchy 
of IBM 7171 support functions. The emphasized utilities can be used from DOS 
BAT files. 



7171 








MAIN 
I 


(7171) 


I 
I/O 


I 

PORTS 

I 

I 






I 
TERMS 
I 
I 
I 
I 
I 
I 
I 
I 




I I 
EDIT.CTL LINK 
I 
I 


I I 
LOAD CONFIG 


I 
SAVE 


I 
REPORT 


I I I 
LOAD EDIT SAVE 


I 

LOAD 


I I 

EDIT SAVE 


I 
REPORT 



Figure C-4. Calling Tree of IBM 7171 Support Functions 



7171 TML 



MAIN (7171TML) 



I III 

MPRT EDIT. TML MLNK I/O 



Figure C-5. Calling Tree of IBM 71 71 TML Support Functions 
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Here is a quick reference list for the nodes of the 7171.COM calling tree. 

1. 7171, C.16, "Main Menu" on page C-20 

a. Ports, C.16. 1, "Ports Menu" on page C-22 

1) Load, "Ports Load" on page C-24 

2) Config, "Ports Configure" on page C-25 

3) Save, "Ports Save" on page C-28 

4) Report, "Ports Report" on page C-29 

b. Terms, C.16.2, "Terms Menu" on page C-31 

1) Load, "Load .TRM" on page C-33 

2) Edit, "Terminal Edit" on page C-34 

3) Save, "Save .TRM File" on page C-44 

4) Report, "Terms Report" on page C-46 

c. Edit .CTL, C.16.3, "Edit .CTL Menu" on page C-50 

1) Load, "Load .CTL" on page C-52 

2) Edit, "Edit .CTL" on page C-53 

3) Save, "Save .CTL File" on page C-54 

d. Link, C. 16.4, "Link" on page C-55 

e. I/O, C. 16.5, "I/O" on page C-57 

Here is a quick reference list for the nodes of the 7171TML.COM calling tree. 

1. 7171TML, C.17, "IBM 7171 Terminal Macro Language for Generating Ter- 
minal Tables" on page C-77 

a. MPRT, C.17, "IBM 7171 Terminal Macro Language for Generating Ter- 
minal Tables" on page C-77 

b. Edit .TML, C.17, "IBM 7171 Terminal Macro Language for Generating 
Terminal Tables" on page C-77, and C.18, "TML Syntax Templates" on 
page C-79 

c. MLNK, C.17, "IBM 7171 Terminal Macro Language for Generating Ter- 
minal Tables" on page C-77 

d. I/O, C.16.5, "I/O" on page C-57 



C.12 IBM 7171 Menu Driven Support Utility for Terminal Tables 



The Menu Driven Support Utility is invoked by entering "7171" on a DOS 
command line. After 7171 has been issued, the user may select different sub utili- 
ties for managing the terminal and ports definitions. 



C.13 Configuring the IBM 7171 Ports 



There are two ways to configure the Ports using the Support Utility: 

• Update a .IMG file by using the Ports-Load, Ports-Configure, and Ports-Save 
screens. 

• Update an image file by using 7171MPRT with a Ports Profile, .PRO file, and 
an image file from 7171LINK or 7171MLNK. 

Note: All terminal types are bound to ports by TDT addresses. This means each 
time a image file is regenerated, the ports must also be regenerated. The exception 
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to this rule is ROM terminal definition tables addresses are constant. Therefore, if 
only ROM terminal types are bound to ports, there will not be a need for regener- 
ating the ports due to reassembly of the image file. 7171MPRT is much easier to 
use for sites which will change TDTs or Port definitions frequently. 

C.13.1 Updating the 7171 Ports 

There are 5 steps involved in updating the ports when using 7171PORT: 

1. Get the current Image file. This could be a newly generated image file from 
7171 LINK, 7171 MLNK, or an image file stored in the 7 1 7 1 . If this is a new 
image which is not in NV-RAM, it is important that the terminal definitions are 
loaded before the ports. 

2. Load the Image data. 

3. Configure the Ports. 

4. Save the reconfigured Ports. 

5. Transmit the Image file to the IBM 7171 through the I/O function. 
There are 4 steps involved in updating the ports when using 7171MPRT: 

1. Create a Port Profile, or update an existing profile. 

2. Get the current Image file. This could be a newly generated image file from 
7171LINK, 717 1MLNK, or an image file stored in the 7 171. If this is a new 
image which is not in NV-RAM, it is important that the terminal definitions are 
loaded before the ports. 

3. Invoke the 7171MPRT processing specifying the port profile and the image file 
which will be stored in the 7171. 

4. Transmit the Ports Image file to the IBM 7171 through the I/O function, 
TERMS then PORTS. 



C.14 Entering a New Terminal Table 



C.14.1 Generating a Completely New Terminal Table 

If the user is going to generate a new table, the following steps are involved: 

1 . Enter all of the data under the "Terms Edit" function: 

Features 
Input Sequences 
Output Sequences 
Login Sequence 
Reset Characters 
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• Graphic Characters 

• Screen size definitions. 

2. "SAVE" the above information into a new .TRM file 

3. Create a ".CTL," Link Control File. 

4. "LINK" all desired terminal tables together 

5. Use the "IO" utility to copy the .IMG file to the IBM 7171 

C.14.2 Modifying an Existing Table 

1 . Load the terminal table through the TERM LOAD function 

2. Modify any data necessary under the Terms Edit function: 

Features 
Input Sequences 
Output Sequences 
Login Sequence 
Reset Characters 
Graphic Characters 
Screen size definitions. 

3. "SAVE" the above information into a .TRM file. 

4. Create a ".CTL," Link Control File using the PE or EDLIN. 

5. "LINK" all desired terminal tables together. 

6. Generate an image if the default values are inappropriate for Ports definitions. 

7. Use the "IO" utility to copy the .IMG file to the IBM 7171. 
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C.15 IBM 7171 Support Utility from Menus 

Figure C-6 illustrates a sample menu. 



MENU TRACE Clock 

MENU NAME 






Input Area 






OPTIONS 
Comments 




Information 
Status 



Figure C-6. Generic IBM 7171 Menu 

The generic menu is divided into the following sections: 

Menu Trace 

This area gives a trace of the menu currently active. It describes the path to 
the current menu. 

Clock 

The optional time and date function are printed here. These can be turned 
on or off by the use of PF keys. In particular PF5 turns the date on, PF6 
turns the date off, PF7 turns on the time, and PF8 turns time off. 

Menu Name 

This is the name of the current menu. 

Input Area 

All user input is entered in this area. 

Options 

All selections are made in this area. Selections might be: next menu, input 
field, or file name. The option is chosen by positioning the cursor over the 
option desired. The cursor may be positioned using any of the following: 
Right, Left, Up, and Down arrows, Home, End, Pg Up, and Pg Dn. These 
keys are located on the right hand side of the PC keyboard. 
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Comments 

This field contains a one line description of the option currently indicated. 

Information 

This line contains useful information pertaining to the current menu, or state 
of the menu. 

Status 

Current input mode, and Insert, Caps lock, and Num Lock indicators are 
printed on this line 

Note: From any menu or screen in the 7171 Support Utility, pressing CTRL-C or 
CTRL-BREAK will terminate the utility and exit to DOS. The best way to exit the 
utility is to select the return and end options. Using CTRL-C will consume the 
available storage. 
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C.16 Main Menu 

Figure C-7 illustrates the MAIN MENU that appears when 7171 is run. 



mm/dd/yy hh: mm AM 
MAIN MENU 



PORTS TERMS EDIT . CTL LINK I/O END 



[F2] or to Select - [F1] for Help 



Figure C-7. Main Menu 

There are 6 options on the main menu to select from: 

PORTS 

This option allows the user to configure the communications ports on the 
IBM 7171. All ports processing is done after selecting this option. 

TERMS 

All "Terminal" processing is done through this selection. This is device spe- 
cific data that allows the IBM 7171 to communicate with that device. 

EDIT CTL 

This is where the .CTL, or Link Control File is created. 

LINK 

This is the function that builds an .IMG file out of the many .TRM files. The 
resultant .IMG file is then ready to transmit to the IBM 7171. 

I/O 

All communication between the PC and the IBM 7171 is done through this 
function. 

END 

This returns the user to DOS. 
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At any point, the user may press Fl for a function-key map, and a very brief 
description of his alternatives will be presented. 

Any one of the above options is selected by moving the cursor to the desired func- 
tion name, and pressing either the Carriage Return key, or the F2 key. 
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C.16.1 Ports Menu 

Figure C-8 illustrates the Ports Menu. 



- PORTS - 

PORTS MENU 



LOAD CONFIGURE SAVE REPORT RETURN 



[F2] or - to Select - [F10] or [ESC] to Quit - [F1] for Help 



Figure C-8. Ports Menu 



The ports function will set the line characteristics for all of the 64 possible ports on 
the IBM 7171. If it is desired to change only one port's line characteristics, it 
would be easier to use the Maintenance Facility Configure Port function. The 
PORTS option in 7171 is useful to set all of the ports to a pre-defined state, or to 
generate reports for system documentation. 

Within the Ports menu, the following functions are available: 

LOAD 

Load an existing .IMG file for ports configuration. 

The LOAD function takes an .IMG from diskette and loads it into the PC 
memory for processing. The .IMG file may have been created by the 
PORTS SAVE command at an earlier time, by I/O to the IBM 7171, 
7171MLNK, or 7171LINK. 

CONFIGURE 

Edit current Ports data set. 

The CONFIGURE option allows editing of the ports values that have been 
loaded into PC memory via the LOAD command. If a load has not been 
done, the data is defaulted. 
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SAVE 

Save current data set in an .IMG file 

The SAVE function takes the ports data from PC memory, and creates a 
.IMG file containing all the current information. This must be done before 
transmitting the data to the IBM 7171 via the I/O routine. Any data that 
was altered during a CONFIGURE session will be stored as it exists at the 
time of the SAVE. 

REPORT 

Generate a hardcopy output of the Ports configuration. 

RETURN 

Return to Main Menu. 
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Ports Load 

Figure C-9 illustrates the Ports Load screen. 



- PORTS - LOAD 

LOAD PORTS IMAGE FILE FOR CONFIGURATION 






Enter filename: 




Example filenames: 
A:MYFILE drive=A: 
MYTERM.IMG drive=def ault 

* filenames may be entered in upper or lower case 

* file extension will default to .IMG 




[F2]=Proceed - [F10]=Cancel - Use [Home] [End] to move cursor - [F1]=Help 
Alphanumeric Input Mode 



Figure C-9. Ports Load Screen 



The user is being prompted for the name of the .IMG file. Ports Load place the 
contents of the image file into memory. If the .IMG file exists in a sub-directory, 
then the entire DOS path name is required. 

All of the standard PC editing keys may be used during file name entry. 
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Ports Configure 



Figure C-10 Illustrates the Ports Configure screen. 



- PORTS 


- CONFIGURE 








CONFIGURE 


EBM 7171 PORTS 




PO 


RT 


BAUD FLAG BIND LIST 


NOTES : 







1A00 


BAUD=0 => AUTO-BAUD 

= 300 600 1200 1800 2400 3600 


1 


1A00 


4800 9600 19200 
or (not auto-baud detectable) 


2 


1A00 


TYPE=<blank>=>End-user will be 
prompted for Terminal Type 


3 


1A00 


FLAG=(sum Flags selected) 

/ 18xx= Even Parity \ choose 


4 


1A00 


\ 08xx= Odd Parity / one 
+ x4xx= 2 Stop bits (0=1 Stop) 


5 


1A00 


+ / x3xx= 8 bit char \ choose 
\ x2xx= 7 bit char / one 


6 


1A00 


+ / xxx3= Local attach 

\ xxx0= Dialup or local attach 


7 


1A00 




[F2] or 


- to Select for Edit - [F10] 


or [ESC] to Return = [F1] for Help 



Figure C-10. Ports Configure Screen 

The following options may be set for each of the 64 ports: 

Option Argument 

BAUD Baud rate. The following baud rates are supported by the IBM 7171 as 
auto baud detectable: 300, 600, 1200, 1800, 2400, 3600, 4800, 9600, 
19200. If the baud rate is set to 0, then the terminal will default to auto 
baud detect mode. 

The following baud rates are supported, but are not detectable in auto 
baud mode: 50, 75, 110, 134, 150, 2000, 7200. 

FLAG Flag word. There are two bytes of flags. The meanings of these flags 
are as follows: 



Byte 1 Flags. 

Bits Meaning 

20 Stick Bit. = Odd or Even Parity, 1 = Mark or Space 
Parity. 
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10 Parity. = Odd or Mark Parity, 1 = Even or Space Parity 
depending on the Stick Bit. 

08 Parity Enable. = Parity Disabled, 1 = Parity Enabled. 

04 Stop Bits. = 1 stop bit, 1=2 stop bits. 

02-01 Data Bits. 00 = 5 data bits, 01 = 6 data bits, 10 = 7 data 
bits, 11 = 8 data bits. 

Byte 2 Flags 

Bits Meaning 

0080 Ignore high order bit of input from terminal. 

0020 Stick bit for output parity generation when high bit of input 
is ignored. 

On or 1 = High order bit is generated as Mark or Space 

parity 

Off or = High order bit is generated as Even or Odd 

parity 

0010 Parity bit for output parity generation when high bit of input 
is ignored. 

On or 1 = Even or Space parity 
Off or = Odd or Mark parity 

Note: The preceding three bits are intended to be used when 
parity is to be ignored on input. The port should be 
configured with eight data bits, parity disabled. 

This configuration option can be done on a per port 
basis, or at a system level. The above port level config- 
uration option is only effective if the system level has 
not been specified. 

02-01 Type of connection. 

00 = Let 7171 determine type of connection 

01 = Switched Network (telephone line) 

10 = Leased Line 

11 = Direct Connection 

If both bits are 0, the TC will automatically determine the 
type of line that is attached. 

BIND This field specifies which terminal type to automatically 

assign to this port at line-connect time. This is the name of a 
valid terminal type whose Terminal Definition Table is cur- 
rently stored in the IBM 7171. If this field is blank, then the 
terminal will prompt with the 'ENTER TERMINAL TYPE' 
message. 
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LIST This field names a terminal which is a member of the specific 
terminal names sublist to present to this port. 

To identify a user defined Terminal Definition Table for the 
BIND or LIST column of the PORTS - CONFIGURE 
screen, LINK must be executed, then the resulting .IMG file 
must be transmitted to the IBM 7171. Then, using the Ports 
LOAD and the same image file which was copied to the 
NV-RAM, the user defined terminals may be bound to ports 
using the Ports CONFIGURE screen. 

An option for a specific port is selected by first moving the cursor over the desired 
option, and then pressing either the F2 or the Carriage Return key. The value is 
then edited in the input area via the normal PC edit keys (i.e. insert, delete, cursor 
right, and cursor left). When the value has been modified, pressing F2 or the Car- 
riage Return again will place the value into PC memory. When all the correct 
values have been set, the memory image is ready to be saved. 

Note: Only eight ports are displayed at any time. The rest of the ports may be 
accessed by using the "Pg Up" and "Pg Dn" keys located on the PC keypad. 



Appendix C. IBM 7171 Support Utility for Modifying Terminal Tables C-27 



Ports Save 

Figure C-ll illustrates the ports save screen. 



- PORTS - SAVE 

SAVE CURRENT CONFIGURATION TO PORTS IMAGE FILE 






Enter filename: 




Example filenames : 
ArMYFILE drive=A: 
MYTERM.IMG drive=def ault 

* filenames may be entered in upper or lower case 

* file extension will default to .IMG 




[F2]=Proceed - [FlO]=Cancel - Use [Home] [End] to move cursor - [F1]=Help 
Alphanumeric Input Mode 



Figure C-ll. Ports Save Screen 



Enter the file name of the .IMG file that the user wishes to save the current config- 
uration. This is the file name that will be used in the I/O function to transmit this 
ports configuration to the IBM 7171. If the user wishes, the file to be stored in 
another sub-directory, then the entire DOS path name must be entered. 
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Ports Report 

Figure C-12 illustrates the ports report screen. 



- PORTS - REPORT 

PORTS REPORT TO PRINTER OR FILE 








Enter filename: 


Example filenames: 






A:MYFILE drive=A: 






MYTERM.RPT drive=def ault 






* filenames may be entered in upper or lower case 






* file extension will default to .RPT 






* PRN: filename will PRINT file - NOT SAVED ON DISK(ETTE) ! 






[F2]=Proceed - [FlO]=Cancel - Use [Home] [End] to move cursor - 
Alphanumeric Input Mode 


- [F1] 


=Help 



Figure C-12. Ports Report Screen 



This option will take the current ports configuration that is in memory, and gen- 
erate output in a report form. The output may be sent to a file, and printed later, 
or may be directed to a printer by entering "PRN:" as the file name. Output may 
also be directed to the user's screen by entering "CON," short for CONSOLE. 

Note: In order to generate a configuration report for a PORTS IMAGE file that 
exists on diskette, it is first necessary to load the .IMG file into memory using the 
PORTS LOAD option. 

Figure C-13 illustrates the form of a typical ports report. 
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IBM 


7171 


Support Utility (C) 


Copyright 


IBM Corp 1984 


, 1985 


Page 1 




















07/04/85 


IBM 


7171 


PORTS REPORT 










7:15 PM 


PORT BAUD 


FLAG 


BIND 


LIST PORT 


BAUD 


FLAG 


BIND LIST 










1A00 




32 





1A00 






1 


9600 


1A00 


HARDCOPY 


33 





1A00 






2 


1200 


1A00 


PLOTTER 


34 





1A00 






3 







1A00 


IBM3 1 1 


35 





1A00 






4 







1A00 


IBM3101 


36 





1A00 






5 







1A00 




37 





1A00 






6 







1A00 




38 





1A00 






7 







1A00 




39 





1A00 






8 







1A00 




40 





1A00 






9 







1A00 




41 





1A00 






10 







1A00 




42 





1A00 






11 







1A00 




43 





1A00 






12 







1A00 




44 





1A00 






13 







1A00 




45 





1A00 






14 







1A00 




46 





1A00 






15 







1A00 




47 





1A00 






16 







1A00 


IBM3 1 1 


48 





1A00 






17 







1A00 




49 





1A00 






18 







1A00 




50 





1A00 






19 







1A00 




51 





1A00 






20 







1A00 




52 





1A00 






21 







1A00 




53 





1A00 






22 







1A00 




54 





1A00 






23 







1A00 




55 





1A00 






24 







1A00 




56 





1A00 






25 







1A00 




57 





1A00 






26 







1A00 




58 





1A00 






27 







1A00 




59 


9600 


1A00 


IBMPC 




28 







1A00 




60 


9600 


1A00 


IBMPC 




29 







1A00 




61 


9600 


1A00 


IBMPC 




30 







1A00 




62 


9600 


1A00 


IBMPC 




31 







1A00 




63 


9600 


1A00 


IBMPC 





Figure C-13. IBM 7171 Ports Report 



Port 1 will operate at 9,600 Bits per second, parity enabled, even parity, with a 
device type of HARDCOPY. 

Port 5 will have parity enabled, even parity, autobaud detection, and the port will 
receive a prompt for the terminal type. 

Port 16 will have an IBM3101 for a device type, parity enabled, even parity, and 
autobaud detection. 
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C.16.2 Terms Menu 

Figure C-14 illustrates the TERMS menu. 



- TERMS - 

TERMS MENU 



LOAD .TRM EDIT SAVE . TRM REPORT RETURN 



[F2] or - to Select - [F10] or [ESC] to Return - [F1] for Help 



Figure C-14. Terms Menu 



The terms function is used to create or modify device specific .TRM files. Each of 
these .TRM files contains the information necessary for the IBM 7171 to com- 
pletely support the use of that device. The .TRM files must later be linked together 
into one TERMINAL IMAGE file, default extension .IMG. 

Within the Terms menu, the following options exist: 

LOAD .TRM 

Load Terminal table from .TRM file into PC memory. 

This function loads a TERMINAL DATA file into PC memory for editing. 

EDIT 

Edit current terminal table that is stored in PC memory. 

This is the function that actually allows the user to modify current Terminal 
Data. 

SAVE .TRM 

Save current Terminal DATA into a .TRM file. 

REPORT 

Generate a report of the terminal table on the printer. 
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RETURN 

Return to the main menu. 
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Load .TRM 



Figure C-15 illustrates the LOAD TERMINAL DATA screen. 



- TERMS - LOAD .TRM 

LOAD .TRM FILE FROM DISK(ETTE) 






Enter filename: 




Example filenames: 
ArMYFILE drive=A: 
MYTERM.TRM drive=default 

* filenames may be entered in upper or lower case 

* file extension will default to .TRM 




[F2]=Proceed - [F10]=Cancel - Use [Home] [End] to move cursor - [Fl]=Help 
Alphanumeric Input Mode 



Figure C-15. Load Terminal Image File 



Enter the file name of a TERMINAL DATA FILE, .TRM. The file will be loaded 
into PC memory, and the terminal tables will be ready for editing. 



) 
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Terminal Edit 

Figure C-16 illustrates the EDIT menu. 



- TERMS - EDIT - 

EDIT MENU 



FEATURES INPUT OUTPUT LOGIN RCHRS SGR ALTSCRN RETURN 



[F2] or - to Select - [F10] or [ESC] to Return - [F1] for Help 



Figure C-16. Terms Edit Menu 



FEATURES 

Edit Terminal Features Flags, Delay, and Cursor Origin. 

INPUT SEQ 

Edit Terminal Input Parse Table. 

OUTPUT SEQ 

Edit Terminal Output Strings. 

LOGIN SEQ 

Enter Terminal Initialization String. 

RESET CHARS 

Enter Terminal Reset Characters. 

GRAPHIC 

Enter Graphic Strings. 

ALTSCRN 

Enter Terminal screen size and 3270 screen size. 

RETURN 

Return to TERMS menu. 
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Please refer to the IBM 7171 Reference Manual and Programming Guide for a 
complete description of these terminal characteristics. 
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Terminal Features: Figure C-17 illustrates the Terminal Features Edit Screen. 



- TERMS - EDIT - FEATURES 

EDIT TERMINAL FEATURE FLAGS, DELAY, CURSOR ORIGIN 










DESCRIPTION HEX 
Flags 0000 
Delay 0000 
Cursor Origin 00 


(see FLAG BITS below) 
(milliseconds) 
(decimal) 




FLAG BITS: 
8000 Hardcopy Terminal 
4000 APL switchable 
1000 Bit paired APL keyboard 
0800 Highlighting can be 

performed 
0400 Highlighting is a mode 


0080 TDT defines screen size 

0040 Can display lower right corner 

without scrolling 
0020 3270 algorithm for NULLS 
0010 Pacing Disabled 
0008 Highlighted blanks different 
0004 3286 Printer Emulation (plus 8000) 


[F2] or - to Select for Edit - 


[F10] or [ESC] to Return - [F1] for Help 



Figure C-17. Terminal Features Edit Screen 



To change any one of the values, place the cursor over the the appropriate field on 
the screen, and press <CR> or F2. Edit the value in the box, and press <CR> or 
F2 again to put a new value into PC memory. 

Please note, the Cursor Origin defaults to X'00', zero. Binary Reposition 
Sequences may require a cursor Origin of SPACE, (X'20'). Also see "Output 
Sequence" on page C-38. 

Warnings may be generated. These do not inhibit process and serve only to point 
out suspect or contradicting data. Here are several common warnings: 

1. CROSS-CHECK Features vs Display Mode vs Graphics, which means the 
highlighting flag is set, but highlighting output sequences have not been 
defined, or the inverse. 

2. CROSS-CHECK FEAT (Delay) = ms, which means delay characters exist 
in an output sequence, but the delay time period equals 0. 

3. WARNING DELAY > 255ms, which points out the delay specified is over a 
quarter of a second which is a long time for most devices. 
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Input Sequence: Figure C-18 illustrates the Terminal Input Sequence Edit Screen. 



- TERMS - EDIT - INPUT SEQ 

EDIT INPUT SEQUENCES 




FUNCTION HEX BINKEY 








Clear 






Enter 






Home 






Left 






Right 






Up 






Down 






Field Tab 






[F2] = Edit - [F9]=Dup Function - [F10] or 


[ESC]=Return - 


- [F1] for Help 



Figure C-18. Terminal Input Sequence Edit Screen 



Two ways exist to edit the input sequences, HEX and BINKEY. To edit either 
field, first move the cursor to the appropriate space on the screen, and press either 
<CR> or F2. 

In HEX input mode, enter the hex digits representing the character desired, then 
press either <CR> or F2. 

In BINKEY input, press the actual key which are desired. For example, if an input 
sequence is to be "ESC J <CR>," press the three keys, "ESC," "J," "<CR>." 
Most ASCII control characters may be entered by pressing the "CTRL" key and a 
graphic character key such as "a," "b," etc, except "CTRL-c" which will terminate 
the utility, use hex mode to input X'03\ To enter the string press F2. To delete a 
keystroke, use the "Del" key. 

Pressing function key F9 will generate a new row entry on the screen. This entry 
will have the same function name as the function row on which the cursor is 
located. This allows generating more than one input sequence for the same func- 
tion. A duplicate string may be erase by using the F2 in the normal editing mode 
and entering an empty sting. 

Note: Only eight input sequences are displayed at any one time. The rest may be 
accessed by using the "Pg Up" and "Pg Dn" keys located on the PC keypad. 
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Output Sequence: Figure C-19 illustrates the Terminal Output Sequence Edit. 



- TERMS - EDIT - OUTPUT SEQ 

EDIT OUTPUT SEQUENCES 










OUTPUT CSS HEX / BINKEY on line after HEX 
Reposition FF 

n/a 
Erase EOL FF 

n/a 
Local Print FF 

n/a 
Tone FF 

n/a 
Cursor Left FF 

n/a 
Cursor Right FF 

n/a 
Cursor Up FF 

n/a 
Cursor Down FF 

n/a 




[F2] or - to Select for Edit - [F10] or [ESC] to Return - [F1] for Help 



Figure C-19. Output Sequences 



Two ways exist to edit the output sequences, HEX and BINKEY. To edit either 
field, first move the cursor to the appropriate space on the screen, and press either 
<CR> or F2. 

In HEX input mode, enter the hexadecimal value of the characters desired, and 
press either <CR> or F2. 

In BINKEY input, press the keys themselves that are desired. For example, if an 
output sequence is to be "ESC J <CR>," press the three keys, "ESC," "J," 
"<CR>." To enter the string into memory, press F2. 

Note: CSSs of up to 16 characters in length are supported. Longer sequences are 
unsupported. The exception is the login, or terminal initialize sequence which may 
be up to 240 characters long. If longer sequences are required, use TML. 

Note: Only eight output sequences are displayed at any one time. The rest may be 
accessed by using the "Pg Up" and "Pg Dn" keys located on the PC keypad. 
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Note: In some cases, the user may require use of some non- ASCII characters. The 
following bytes must be entered in HEX mode. Their equivalent BINKEY display 
is also shown: 

Byte BINKEY representation 

XEC c_f (CHARFLD) 

XEE b_f (BINFLD) 

XF2 dly (DELAY) 

XF4 u_y (USERY) 

XF6 u_x (USERX) 

XF8 c_y (CHARY) 

XFA c_x (CHARX) 

XFC b_y (BINY) 

XFE b x (BINX) 
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Login Sequence: Figure C-20 illustrates the Terminal Login Sequence Edit. 



TERMS - EDIT - LOGIN SEQ 

EDIT LOGIN INITIALIZATION SEQUENCE 



FF 



n/a 



[F2] or - to Select for Edit - [F10] or [ESC] to Return - [F1] for Help 
NOTE: IN-PLACE EDIT, MAX LENGTH = 240 CHARS 



Figure C-20. Login Initialization Sequence 



The Terminal Initialization String is edited separately because it can be up to 240 
characters in length. 

Two ways exist to edit the login sequences, HEX and BINKEY. To edit either 
field, first move the cursor to the appropriate space on the screen, and press either 
<CR> or F2. In HEX input mode, enter the representation of the bytes desired, 
and press either <CR> or F2. 

In BINKEY input, press the keys themselves that are desired. For example, if an 
initialization string is to be "ESC J <CR>," press the three keys, "ESC," "J," 
"<CR>." To enter the string into memory, press F2. 

Again, special non- ASCII characters such as the DELAY character must be 
entered in HEX mode. 
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Reset Characters: Figure C-21 illustrates the reset character screen. 



- TERMS - EDIT - RESET CHARS 

EDIT RESET CHARACTERS 



CHARACTER 

Reset Introducer . 

Master Reset 

Char Error Reset . 

3270 'Reset' 

Input Buffer Flush 
Pacing Start Char 
Pacing Stop Char . 
Maintenance Facility 



HEX BINKEY 
FF n/a 



FF 
FF 
FF 
FF 
FF 
FF 
FF 



n/a 
n/a 
n/a 
n/a 
n/a 
n/a 
n/a 



NOTES : 

ANY UNUSED CHARACTERS SHOULD BE 
X'FF' NOT X'00' = null character 



[F2] or - to Select for Edit - [F10] or [ESC] to Return - [F1] for Help 



Figure C-21. Reset Characters 



Two ways exist to edit the reset characters, HEX and BINKEY. To edit either 
field, first move the cursor to the appropriate space on the screen, and press either 
<CR> or F2. 

In HEX input mode, enter the hex value of the character desired, then press either 
<CR> or F2. 

In BINKEY input, press the keys themselves that are desired. For example, if an 
reset character is to be "CTRL - A," press the key, "CTRL - A." To enter the 
string into memory, press F2. 

For information describing the RESET characters, see "Reset Character Keyboard 
Sequences" on page 4-9. 
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Graphics Strings Figure C-22 illustrates the graphic string screen. 



- TERMS - EDIT - GRAPHIC 

EDIT GRAPHIC RENDITION CONTROL STRING 












DESCRIPTION HEX 
Primary 0000000000 
Alternate 0000000000 

12 3 4 


BINKEY 

NUL NUL NUL NUL NUL 
0— 1— 2 — 3— 4 — 
NUL NUL NUL NUL NUL 
0— 1— 2— 3— 4— 
(See Notes below) 






NOTES : 

= Non-display 

1 = Normal display unprotected 

2 = High Intensity unprotected 

3 = Normal display protected 

4 = High Intensity protected 


[F2] or - to Select for Edit - [F10] 


or [ESC] to Return - 


[F1] for Help 



Figure C-22. Set Graphics Strings 



Two ways exist to edit the graphics strings, HEX and BINKEY. To edit either 
field, first move the cursor to the appropriate space on the screen, and press either 
<CR> or F2. In HEX input mode, enter the representation of the bytes desired, 
and press either <CR> or F2. 

In BINKEY input, press the keys themselves that are desired. For example, if an 
graphics byte is to be "CTRL - A," press the key, "CTRL - A." To enter the 
string into memory, press F2. 

For information on Graphic Rendition Control Strings see "Graphic Rendition 
Strings ' ' on page 4-16. 



C-42 IBM 7171 Reference Manual and Programming Guide 



Terminal Screen Size Definitions: Figure C-23 illustrates the Terminal Edit Screen 
Size Definitions 



- T 


ERMS - 


EDIT - ALTSCRN 

EDIT SCREEN SIZE 


DEFINITIONS 














HEX 


DECIMAL 








Default 


physical rows 


00 









Default 


physical columns 


00 









Default 


logical rows 


00 









Default 


logical columns 


00 









Alternate physical rows 


00 









Alternate physical columns 


00 









Alternate logical rows 


00 









Alternate logical columns 


00 









[F2] or - 


to Select for Edit 


- [F10] 


or [ESC] to Return - 


■ [F1] 


for Help 



Figure C-23. Terminal Screen Size Definitions 



Any value of zero is equivalent to entering the default value. For rows, the default 
is 24 rows. For columns, the default is 80 columns. 

To change any one of the values, place the cursor over the the appropriate field on 
the screen, and press <CR> or F2. Edit the value in the box, and press <CR> or 
F2 again to put a new value into PC memory. 

Note: The term PHYSICAL refers to the terminal. 

Note: The term LOGICAL refers to the 3270 system gen ie. 3278 Model Group 
5, 27 rows by 132 columns. 
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Save .TRM File 



- TERMS - SAVE .TRM 

SAVE .TRM FILE TO DISK(ETTE) 






Enter 8 character Terminal name: 










[F2]=Proceed - [FlO]=Cancel - Use [Home] [End] to move cursor - [F1]=Help 
Alphanumeric Input Mode 



Figure C-24. Save Terminal Name 

Two pieces of information are required to save a terminal data file: 

1 . Name of the Terminal Type 

The name of the terminal type will be the name the user types for the "ENTER 
TERMINAL TYPE" message. 

2. Name of Terminal Data File 

The name of the file is the name that all of the data will be stored under. This 
name is also used in the control file at link time. 

The first screen that appears when a save is initiated is illustrated in Figure C-24. 
After the terminal name is entered, press F2 or Carriage Return to continue on to 
the next screen, illustrated in Figure C-25. 
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- TERMS - SAVE . TRM 

SAVE .TRM FILE TO DISK(ETTE) 






Enter filename: 




Example filenames: 
ArMYFILE drive=A: 
MYTERM.TRM drive=def ault 

* filenames may be entered in upper or lower case 

* file extension will default to .TRM 




[F2]=Proceed - [F10] =Cancel - Use [Home] [End] to move cursor - [Fl]=Help 
Alphanumeric Input Mode 



Figure C-25. Save .TRM File 



This is the screen on which the name of the .TRM file is entered. After the name is 
entered, press F2 or Carriage Return to proceed, F10 or ESC will return the user 
back to the TERMS menu. 

DOS pathnames may be used as part of the Filename. 
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Terms Report 

Figure C-26 illustrates the terms report screen. 



- TERMS - REPORT 

TERMINAL REPORT TO PRINTER OR FILE 






Enter filename: 




Example filenames : 
ArMYFILE drive=A: 
MYTERM.RPT drive=def ault 

* filenames may be entered in upper or lower case 

* file extension will default to .RPT 

* PRN: filename will PRINT file - NOT SAVED ON DISK(ETTE) ! 




[F2]=Proceed - [F10]=Cancel - Use [Home] [End] to move cursor - [F1]=Help 
Alphanumeric Input Mode 



Figure C-26. Terms Report Screen 



This option will take the current terminal configuration that is in memory, and gen- 
erate output in a report form. The output may be sent to a file, and printed out 
later, or may be directed to a printer by entering "PRN:" as the file name. 

Alternatively the report may be viewed at the user's screen by entering "CON:." 

Note: In order to generate a configuration report for a TERMS IMAGE file that 
exists on diskette, it is first necessary to load the .IMG file into memory using the 
TERMS LOAD option. Figure C-27 illustrates a typical Terminal Report. 
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IBM 7171 Support Utility (c) Copyright IBM Corp 1984, 1985 


Page 1 








07/06/85 


'TEST' TERMINAL TABLE DEFINITION 




5:01 PM 


FEATURES : 








DESCRIPTION HEX 








Flags 0880 








Delay 0000 (milliseconds) 




Cursor Origin 01 1 (decimal) 






SCREEN SIZE DEFINITIONS 








SPACE 1 










HEX 


DECIMAL 




Default Physical Rows 


00 


000 




Default Physical Columns 


00 


000 




Default Logical Rows 


00 


000 




Default Logical Columns 


00 


000 




Alternate Physical Rows 


00 


000 




Alternate Physical Columns 


00 


000 




Alternate Logical Rows 


00 


000 




Alternate Logical Columns 


00 


000 




RESET CHARACTERS (RCHRS) : 








CHARACTER HEX BINKEY 






Reset Introducer .... FF n/a 






Master Reset 07 BEL 






Char Error Reset .... FF n/a 






3270 'Reset 1 FF n/a 






Input Buffer Flush . . FF n/a 






Pacing Start Char ... 11 XON 






Pacing Stop Char 13 XOFF 






Maintenance Facility. OF SI 








GRAPHIC RENDITION CONTROL CHARACTERS 


(SGR) : 




DESCRIPTION HEX 


BINKEY 






Primary 02 00 01 00 


07 STX 


NUL SOH NUL BEL 




Alternate 02 01 00 01 


07 STX 


SOH NUL SOH BEL 




0- 1- 2- 3- 


4- — 


1— 2— 3— 4— 




OUTPUT SEQ (CSS) : 








OUTPUT CSS HEX / BINKEY 


on line 


after HEX 




Reposition 1B5BF83BFA48 








ESC [ c y ; 


c_x H 






Erase EOL 1B5B4B 








ESC [ K 








Local Print 1B5B50 








ESC [ P 








Tone 07 








BEL 








Cursor Left 1B5B44 








ESC [ D 








Cursor Right 1B5B43 








ESC [ C 








<Reserved> <none> 








<Reserved> <none> 








Enter Insert 1B5B77496E736572740D 






ESC [ w I 


n s 


e r t CR 




Exit Insert 1B5B770D 








ESC [ w CR 








Disconnect 1B5B481B5B4A 








ESC [ H ESC [ J 






Clear 1B5B481B5B4A 








ESC [ H ESC [ J 







Figure C-27 (Part 1 of 3). Terminal Report 
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IBM 7171 Support Utility 


(c) Copyr 


ight IBM Corp 


1984, 1985 


Page 2 
















07/06/85 


'TEST 1 TERMINAL TABLE DEFINITION 










5:01 PM 


OUTPUT SEQ (CSS) : 














OUTPUT CSS 


HEX / BINKEY on 1 


ine after 


HEX 






Login Init 


1B5B481B5B4A1B5B771B5B376D204C4F474F4E200D 






ESC [ H 


ESC [ 


J ESC 


w 


ESC [ 7 


m spc L O 




G N 


spc CR 












Illegal Char 


3A 














APL Illegal 


<none> 














APL Chars ON 


<none> 














APL Chars OFF 


<none> 














Display Mode 


1B5BEC6D 
ESC [ c_ 


f m 












Clear Alt Scr 


<none> 














INPUT SEQ (NODE) : 














INPUT SEQ 


HEX 




BINKEY 








Clear 


1B5B4A 




ESC 


[ 


J 






Enter 


0D 




CR 










Home 


1B5B48 




ESC 


[ 


H 






Left 


1B5B44 




ESC 


[ 


D 






Right 


1B5B43 




ESC 


[ 


C 






Up 


1B5B41 




ESC 


[ 


A 






Down 


1B5B42 




ESC 


[ 


B 






Tab 


09 




HT 










Tab Back 


1B09 




ESC 


HT 








New Line 


0A 




LF 










Insert 


1B5B3468 




ESC 


[ 


4 


h 




Delete 


7F 




DEL 










Erase EOF 


1B5B4E 




ESC 


[ 


N 






Insert 


1B5B346C 




ESC 


[ 


4 


1 




Erase Input 


1B5B4B 




ESC 


[ 


K 






DUP 


04 




EOT 










FM 


06 




ACK 










Sys Request 


1B535953 




ESC 


S 


Y 


S 




PA 1 


1B504131 




ESC 


P 


A 


1 




PA 2 


1B504132 




ESC 


P 


A 


2 




PA 3 


1B504133 




ESC 


P 


A 


3 




PFK 01 


1B3031 




ESC 





1 






Reshow 


1B52 




ESC 


R 








Col Tab 


14 




DC4 










Col Tab Back 


02 




STX 










Set Tab 


1B54 




ESC 


T 








Set Margin 


1B4D 




ESC 


M 








Delete Tab 


1B44 




ESC 


D 








Set Home 


1B48 




ESC 


H 








Indent 


1B49 




ESC 


I 








Undent 


1B55 




ESC 


U 








Disconnect 


18 




CAN 










Re-connect 


OC 




FF 










Zones Off 


1B5A 




ESC 


Z 








Zones On 


1A 




SUB 










Set Num only 


0E 




SO 










Set Alpha/Num 


01 




SOH 










3277 INSERT 


1B3737 




ESC 


7 


7 







Figure C-27 (Part 2 of 3). Terminal Report 
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IBM 7171 Support Utility (c) Copyright IBM 


Corp 1984, 1985 Page 3 
















07/06/85 


'TEST 1 TERMINAL 


TABLE DEFINITION 








5:01 PM 


INPUT SEQ (NODE 


: 












INPUT SEQ 


HEX 




BINKEY 






3278 INSERT 


1B3738 




ESC 


7 


8 




Local Print 


1B5B50 




ESC 


[ 


P 




Cursor Select 


1B43 




ESC 


C 






PFK 


02 


1B3032 




ESC 





2 




PFK 


03 


1B3033 




ESC 





3 




PFK 


04 


1B3034 




ESC 





4 




PFK 


05 


1B3035 




ESC 





5 




PFK 


06 


1B3036 




ESC 





6 




PFK 


07 


1B3037 




ESC 





7 




PFK 


08 


1B3038 




ESC 





8 




PFK 


09 


1B3039 




ESC 





9 




PFK 


10 


1B3130 




ESC 


1 







PFK 


11 


1B3131 




ESC 


1 


1 




PFK 


12 


1B3132 




ESC 


1 


2 




PFK 


13 


1B3133 




ESC 


1 


3 




PFK 


14 


1B3134 




ESC 


1 


4 




PFK 


15 


1B3135 




ESC 


1 


5 




PFK 


16 


1B3136 




ESC 


1 


6 




PFK 


17 


1B3137 




ESC 


1 


7 




PFK 


18 


1B3138 




ESC 


1 


8 




PFK 


19 


1B3139 




ESC 


1 


9 




PFK 


20 


1B3230 




ESC 


2 







PFK 


21 


1B3231 




ESC 


2 


1 




PFK 


22 


1B3232 




ESC 


2 


2 




PFK 


23 


1B3233 




ESC 


2 


3 




PFK 


24 


1B3234 




ESC 


2 


4 




PFK 


25 


1B3235 




ESC 


2 


5 




PFK 


26 


1B3236 




ESC 


2 


6 




PFK 


27 


1B3237 




ESC 


2 


7 




PFK 


28 


1B3238 




ESC 


2 


8 




PFK 


29 


1B3239 




ESC 


2 


9 




PFK 


30 


1B3330 




ESC 


3 







PFK 


31 


1B3331 




ESC 


3 


1 




PFK 


32 


1B3332 




ESC 


3 


2 




PFK 


33 


1B3333 




ESC 


3 


3 




PFK 


34 


1B3334 




ESC 


3 


4 




PFK 


35 


1B3335 




ESC 


3 


5 




PFK 


36 


1B3336 




ESC 


3 


6 











Figure C-27 (Part 3 of 3). Terminal Report 
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C.16.3 Edit.CTL Menu 

Figure C-28 illustrates the EDIT .CTL menu. 



- EDIT - 

EDIT .CTL MENU 



LOAD .CTL EDIT .CTL SAVE .CTL RETURN 



[F2] or - to Select - [F10] or [ESC] to Return - [F1 ] for Help 



Figure C-28. Edit .CTL Menu 



The .CTL function allows a user to create or modify a link control file. The .CTL 
file is in text format. The .CTL file can be created with a standard text editor as 
well as modified. The file format is a string of arguments, separated by spaces or 
commas. The arguments specify which .TRM files are to be linked into the TER- 
MINAL IMAGE file that is to be transmitted to the IBM 7171, and in what order 
the terminal names which appear after the "VALID TYPES ARE" message are in. 
The arguments are: 

7171 mative termname 

This tells the linker to include this native IBM 7171 terminal type into the list at 
this point. Valid terminal names are: ADM31, ADM3A, DM1520, DM1521, 
DM3045, IBM3101, TVI912, TVI920, TVI950, TVI950R, VT100, HARD- 
COPY, and TYPETERM. These terminals are described in 
Appendix B, "IBM 7171 Supplied Terminal Definition Tables" on page B-l, 
and Appendix D, "Interface for User Supplied Table Modification Program" 
on page D-l of the IBM 7171 Reference Manual and Programming Guide. 

file.trm 

This is the name of a .TRM TERMINAL DATA FILE. The terminal name 
that was specified in the menu illustrated in Figure C-24 is added to the list of 
terminal names at this point. 

+ 

Indicates that a Carriage Return is to be put out after the previous terminal 
name in the message. 
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Indicates that the rest of the terminal names are to be hidden. 

% 

Indicates that a sublist follows. 

Note: Only those terminals whose names are listed in the .CTL file, either native 
IBM 7171 or user generated, will be included in the .IMG file. If the user wishes 
all of the native terminal names to be included, then the user MUST list the ter- 
minal names in the .CTL file. 717110 utility requires TYPETERM. 

See C.7.2, ".CTL files" on page C-6 for examples of .CTL files. 

Within the Edit .CTL menu, the following functions are available: 

LOAD 

Load an existing .CTL file for editing. The LOAD function takes a .CTL 
from diskette and loads it into the PC memory for processing. 

EDIT 

Edit current .CTL file. The EDIT option allows editing of the .CTL file that 
has been loaded into PC memory via the LOAD command. If a .CTL file 
has not been loaded, the screen will appear blank, and a new file may be 
created. 

SAVE 

Save current file to a .CTL file. The SAVE function takes the current infor- 
mation from PC memory, and creates a .CTL file. This must be done before 
linking the .TRM files together. 

RETURN 

Return to Main Menu. 

Note: Edit .CTL is provided for convenience. The user is free to use any text 
editor. 
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Load .CTL 

Figure C-29 illustrates the LOAD .CTL screen. 



- EDIT - LOAD .CTL 

LOAD .CTL CONTROL FILE FOR EDITING 








Enter filename: 




Example filenames: 
A:MYFILE drive=A: 
MYTERM.CTL drive=def ault 

* filenames may be entered in upper or lower case 

* file extension will default to .CTL 






[F2]=Proceed - [F10]=Cancel - Use [Home] [End] to move cursor - 
Alphanumeric Input Mode 


- [F1]=Help 



Figure C-29. Load .CTL File 



Enter the file name of a Control File. The file will be loaded into PC memory, and 
be ready for editing. 

DOS pathnames may be part of the filename. 



C-52 IBM 7171 Reference Manual and Programming Guide 



Edit .CTL 

Figure C-30 illustrates the edit screen. 



EDIT - EDIT .CTL 

EDIT .CTL CONTROL FILE 
















[F2] or *- to Select - [F10] or [ESC] to Return - [F1] for Help 



Figure C-30. Edit .CTL Screen 



Each line on the screen represents one line in the .CTL file. To change a line, 
move the cursor over the line, and press F2 or <CR>. The line will then appear in 
the input area at the top of the screen. Change the line, and then press F2 or 
<CR> again. This will update the line in PC memory. 

To delete a line, delete all characters on that line, then enter it. The line will 
appear to be there, but it will not be saved in the file system. 

Note: If the screen becomes jumbled, save the file, then reload the file. 

Note: For help with the syntax of .CTL files, see C.7.2, ".CTL files" on 
page C-6 

Note: 7 17 HO utility requires TYPETERM is a valid terminal type. 

See C.16.3, "Edit .CTL Menu" on page C-50 for .CTL examples. 
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Save .CTL File 

Figure C-31 illustrates the save .CTL screen. 



- EDIT - SAVE .CTL 

SAVE .CTL CONTROL FILE ON DISK(ETTE) 








Enter filename: 




Example filenames : 
A:MYFILE drive=A: 
MYTERM.CTL drive=default 

* filenames may be entered in upper or lower case 

* file extension will default to .CTL 






[F2]=Proceed - [FlO]=Cancel - Use [Home] [End] to move cursor - 
Alphanumeric Input Mode 


- [F1]=Help 



Figure C-31. Save .CTL Menu 



Enter the new name for the .CTL file currently in memory. This will save the 
.CTL file. 



C-54 IBM 7171 Reference Manual and Programming Guide 



C.16.4 Link 

Figure C-32 illustrates the LINK menu. 



- LINK 

INITIALIZE FILENAMES FOR 71 71 LINK 






CONTROL FILE: 
OUTPUT FILE : 




NOTES : 






CONTROL FILE MUST EXIST - RUN EDIT .CTL TO CREATE ONE 






CONTROL FILE DEFAULT EXTENSION = .CTL 






OUTPUT FILE DEFAULT EXTENSION = .IMG 






[F9] TO BEGIN 7171LINK PROCESSING 






[F2] or - to Select for Edit - [F10] or [ESC] to Return - 


[F1] 


for Help 



Figure C-32. 7171LINK Menu 

Specify a control file name by selecting the field, and inputting the path and file 
name of the .CTL file that is to control the linking process. The link will produce a 
file whose output file name is specified in the second field. That file will be a TER- 
MINAL IMAGE file ready for I/O to the IBM 7171. 

A link report is generated during the process. This report gives the following infor- 
mation: 

1 . An indication that the .CTL file is in the proper format. 

2. An indication of each terminal name in the .CTL file, as it is being linked, and 
any error or warning messages associated with that terminal. Typically 
warning messages and errors are assembled. 

3. Statistical Data comprising the following: 

a. Total number of bytes in the TERMINAL IMAGE file 
*) b. Total number of bytes saved during the optimization of the terminal tables 

c. Total number of free bytes remaining. 
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4. A copy of the VALID TYPES ARE message, as it will appear to terminals con- 
nected to the IBM 7171. 

Note: Cross-Check messages indicate a certain TDT contains data which is 
normally contradictory. The .TRMs are linked without changes. This message 
should be considered a warning. 
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C.16.5 I/O 



Figure C-33 illustrates the I/O menu. 



- I/O 



INITIALIZE PARAMETERS FOR 717110 



Function: _ [ Get | Put ] 

Type: _ [ Ports I Terms ] 

IMAGE FILE: 

Password: 

Option: 



[2 if COM2: I leave blank for C0M1 : ] 



NOTES : 

IMAGE FILE DEFAULT EXTENSION = .IMG 



[F9] TO BEGIN 717110 PROCESSING 



[F2] or - to Select for Edit - [F10] or [ESC] to Return - [F1] for Help 



Figure C-33. 7171IO Menu 



All information is sent and retrieved from the IBM 7171 via this function. 
Remember, if the communications port was not initialized during the installation, 
then I/O between the PC and the IBM 7171 cannot take place. If necessary refer 
back to the installation procedure. The meaning of the different data fields are as 
follows: 

Function Get or Put. G indicates that this is a transaction to GET data from 

the IBM 7171, P indicates that this is a transaction to PUT data into 
the IBM 7171. 

Note: Executing a PUT will likely disrupt your user's session. 

Type Ports or Terms. P indicates that the transaction will take place with 

a PORTS IMAGE FILE, and T indicates that the transaction will 
take place with a TERMINAL IMAGE FILE. 

IMAGE FILE This is the name of the IMAGE file to be transmitted. 

Password. This is the ZAP password described on 9.5, "How to Change the 

Password and Parse Tables" on page 9-3. It is initially set to 
i @@ZP&@@\ This password allows special access to the IBM 
7171. 
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Note: Do not make the ZAP password the same as the Mainte- 
nance Facility password. Each password must be unique. 

Option If transmission is taking place through the COM2: port, then 

specify '2'. 

Note: Before any I/O can take place, the communications port must be initialized 
through DOS. The settings must coincide with the port configuration set in the 
IBM 7171 for port 0. The initial setting is for auto baud detect, Even Parity, Seven 
Data Bits, One Stop Bit. To transmit at 1200 bits per second the following DOS 
command must be issued: 

MODE COM1 :1200,E,7,1 

or 
MODE COM1 :12 

Both perform the same task, the second option is a standard DOS abbreviation. 

For a dedicated line, an operator only has to invoke the 7171IO utility via the 
menu selection process or by issuing the 717 HO command. If a switched line is 
used, first an operator must establish the connection over the switched network. 
The method of dialing into the system is modem dependent. Once the connection 
is established, then the operator proceeds as for a dedicated line. 

See the section on DOS Bat files. 

An example of a bat file for automatic dial up is: 

ECHO >COM1 

PAUSE 

717110 {Get I Put} {Ports I Term} filename . IMG password [2] 

Executing the DOS ECHO command, outputs the dialing sequence to a modem 

which has auto dialing capability. The " " indicates that the user must put in a 

modem specific character string which will make the auto dial-in connection. 

Execution of the PAUSE command will provide the prompt, "Strike a key when 
ready." Press any Key after the connection is made. The Pause command is not 
required for direct connections. It is simply a tool for delaying execution until the 
user is sure the modem has established a connection. 

Executing the last command invokes the IBM 7171 Support Utility which inputs or 
outputs .IMG files of the IBM 7171. If 2 is not specified in the command, the 
input or output will default to PC communications port COM1:. 

C.16.6 I/O Utility Communications 

The 7171IO utility requires: 

• Initialization of the COM port to the settings specified for PORT 0. 

• A connection to PORT 0, which may be direct, by modem, or an equivalent see 
IBM 71 71 ASCII Device Attachment Control Unit Description and Planning 
Guide for help with cable configuration. The 7171IO utility requires CTS and 
DSR signals for transmission. 
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Handling Error Situations 



• PORT should be autobaud detect, or bound to a baud which is compatible 
with the COM port. 

• TYPETERM must be a VALID terminal type. 

• The ZAP interface password must be known and be unique with respect to the 
Maintenance Facility password. 

• The port mustn't be past the ENTER TERMINAL TYPE message. 

If the IO utility terminates with an ABEND 1, 2, 3, 4, 5, or 6, then it is very likely 
one of the above conditions has not been met. 



If the 7 17 HO utility abnormally ends execution, ABEND, then there are several 
steps which should be taken. 

1 . Record the entire error message in detail. 

2. Describe the environment. Is there a DOS extension operating on an interrupt 
basis? 

3. Identify which stage of execution generated the ABEND condition. 

• Stage 1 SYNTAX, this stage begins upon execution and ends at the 
Dialup/Connect begun... message. 

• Stage 2 LOGON, this stage begins with the Dialup/Connect begun... 
message and ends at the ...Connected message. 

• Stage 3 DATA TRANSFER, this stage follows the LOGON and ends 
when the 7171 LOGOFF: is seen. 

• Stage 4 Session termination, this stage exits from the ZAP interface, and 
writes any files currently stored in the PC memory. 

4. Check the 7171IO Error Code section for hints or suggestions for correcting 
error conditions. Correct any problem identified. 

5. Attempt to execute the 7171IO utility again even if a problem cannot be deter- 
mined. 

Failure of the 7171IO utility generally is a symptom of other problems. By identi- 
fying the stage of execution at which the abnormal condition arises, the user can 
attempt to take corrective action. 

7171IO SYNTAX Errors: Failure at STAGE 1 should be easily handled by cor- 
recting the syntax, generally this only applies to users using the DOS bat file 
facility. 
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7 17 HO LOGON Errors: Failure at STAGE 2 is the most frequent. Failure at this 
stage is a result of: 

1. Incorrect cabling. Transmission requires CTS and DSR are presented. Be sure 
the cable conforms to IBM 71 71 ASCII Device Attachment Control Unit 
Description and Planning Guide. It is the user's responsibility to see that the 
cable conforms to the specifications presented, usually ABEND -3,-5,and -6. 

2. TYPETERM is not a valid terminal type, usually ABEND -3. 

3. The ZAP interface password must be correct and unique with respect to the 
Maintenance Facility password, usually ABEND -3. 

4. If modems are in use, then time must be given to allow the modems to establish 
the communication protocol. This time varies from fractions of a second up to 
30 seconds. This modem communication setup delay time is modem dependent 
and it is the user's responsibility to control the environment, usually ABEND 
-5,and -6. 

5. Port was past the ENTER TERMINAL TYPE STATE, usually an Echoback 
error stating a X ' 0D * was sent and X ' IB ' was received. The X ' IB: ' is an 
escape character associated with a cursor reposition function of the active ter- 
minal type. ABEND -5. 

6. A DOS extension running in background or on an interrupt driven basis which 
uses too many of the CPU cycles which the 7171IO utility needs for serving 
the RS-232 port, usually ABEND -6. 

Errors such as 2 and 3 can quickly be identified with the use of a terminal or a 
terminal emulation. 

For 2 get to the ENTER TERMINAL TYPE message. Press the Carriage 
return to see the VALID TYPES ARE list. Is TYPETERM is in the list? If 
not the user will need to log onto the Maintenance Facility to check the ter- 
minal names list which begins at DC00:300. If assistance is needed refer to 
4.6.1, "Terminal Names List" on page 4-45. 

For 3 

ENTER M DC00:2A0 8 

RESPONSE DC00:2A0 16 hex digits your password 

If this doesn't correspond with your password, either make note of the correct 
password or change it using the PW Z command. 

For 6 the user needs to know the programs which are currently running in the 
PC. 

For 1 and 4 it requires a closer look at the equipment. The cable is the most 
frequent cause of problems at the LOGON stage. 

7 17 HO LOGON Sequence: This is a description of the events which must take 
place to successfully LOGON to the ZAP interface. 
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Messages 
Dialup/Connect begun 



PASSWORD transmitted 



TYPETERM transmitted 



3) 
4) 



5) 
6) 



.Connected 



Activity taking place 

1 ) Raise DTR and RTS 

2) Transmit a "#" 

If CTS and DSR are not presented 

Then 

ABEND - 1 

# init XMT ERR= 

Likely a cable problem 
Clear the line 
Ignore incoming characters 
Transmit a CR, XOD 
If CTS and DSR are not presented 

Then ABEND - 4 
Else If not echoed Then ABEND - 5 
Clear the line 
Transmit the ZAP Password 
If CTS and DSR are not presented 

Then ABEND - 4 
If Zap password 

is not Echoed Then 

ABEND -5 

UNRECOVERABLE ERROR DURING ECHOBACK 

Check the connection and the cable 

7) Transmit a CR, XOD 

8) Clear the line 

9) Transmit "TYPETERM" 

If CTS and DSR are not presented 

Then ABEND - 4 
If "TYPETERM" is not Echoed Then 

ABEND -5 

UNRECOVERABLE ERROR DURING ECHOBACK 

Check the connection and 

the cable 

10) Clear the line 

11) Transmit "?" 

If CTS and DSR are not presented 

Then ABEND - 4 
If "?" is not Echoed Then 

ABEND -5 

UNRECOVERABLE ERROR DURING ECHOBACK 

Check the connection and 

the cable 

12) Read RS-232 

If Buffer <> "Error" Then 
If Buffer is Empty Then 
ABEND -6 

UNRECOVERABLE ERROR DURING IORCV 
The cable may not be correctly 
configured 
If Buffer <> "Error" Then 

If Buffer is not empty Then 
ABEND -3 

LOGON UNRECOVERABLE ERROR: 
TYPETERM is not a valid 
terminal type, 
Wrong Password, 

the modems had not established 
a communication path when 
the 717110 utility began 
transmission, or the port 
was already in session. 
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7171IO Error Codes 



Once the Connected message appears, the 7171IO utility will usually run to com- 
pletion. If the user is experiencing problems with the cable, make sure Ring Indi- 
cator is properly handled as well as the remainder of the RS-232 interface. 

7171IO DATA TRANSFER Errors: These errors are unusual. If the 7171IO utility 
was performing a GET function, try executing the utility a second ^ime. If the 
7 17 HO utility was performing a PUT TERM function, it may require TYPETERM 
to be inserted into the terminal names list. The source of errors here could be: 

1. Improper cabling, if a line monitor is available watch for noise on the lines or 
for signals to drop. 

2. Asynchronous Adapter Overrun, which is usually the result of CPU cycles 
being stolen by a resident program. 

71 71 TO Session Termination Errors: These are usually the result of not having room 
for a file on the diskette specified. Cable, resident programs, and noise problems 
normally will be detected before reaching this point. 



The following section explains the meaning of error codes which are shown during 
the operation of the IBM 7171 Support Utility. 

717110 Abend codes 

-1 initial '#' transmission 

-2 initial [CR] for auto baud detect 

-3 initial '?' for verification (after password S TYPETERM) 
Problem is usually, TYPETERM is not a valid 
Terminal Type. If this is the case, then 
fix the situation by Reset Ram, or using 
Operator, patch in TYPETERM. 

-4 during transmission 
-5 during echoback 

Characters were sent, but not echoed, 

Problem is usually incorrect cabling, wrong ZAP Password, 
Zap Password is stored at DC00:02A0, TYPETERM is not a 
valid type, or PORT was active from previous session. 
-6 during receive 

717110 utility is expecting characters to be entering the 
RS-232 port. 
Note, Abends with values -6 to -1 mean I/O could not establish 
or maintain a communication path with the Zap Facility. 
Some programs which stay resident in DOS, such as terminal 
emulators, and ''hot 11 key programs, steal CPU cycles from the 
Personal Computer. This could lead to an ABEND due to an 
overrun on the Asynchronous Communications Adapter. If the user 
has resident DOS programs , remove them and try again (in some 
cases these resident programs are loaded by the autoexec.bat 
file) . 

-12 unexpected 7171 Dump response (7171 problem) 
-13 unexpected 7171 Dump data (7171 problem) 
-99 unexpected 7171 Dump response (7171 problem) 

7171IO: Error Opening 'xxxxxxxx' file 

7 17 HO This error message appears in the output listing for both read and 
write files. Reinvoke 7171IO with the file name spelled correctly and be 
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sure the diskette drive and (sub) directory are correct. If writing to a 
diskette, check it for a write-protect tab. 

7171IO ABEND CODE = nn 

This abnormal end error message appears in the output listing at the end of 
7 17 HO processing. (See the 7171IO Codes table above.) 

7171IO utility apparently out-of-sync with IBM 7171 *** 
Buffer= (buffer data) 
Abort, Retry, or Ignore?: 

7 1 7 1 IO This prompt appears when the 7 1 7 1 IO utility is apparently out-of- 
sync in communicating with the IBM 7171. Buffer data is for diagnostic 
information only. Enter "R" for Retry or "A" for Abort and redial. 

ABEND: transmitting # <illegal> to abort 7171 

7 17 HO This Abnormal end message appears after 7171IO detects a commu- 
nications or logon error. After the communications link is severed, the user 
may reconnect and rerun 7171IO. 

# init XMT ERR=nnnn + xxxx 

7 17 HO (abend -1) This error message appears when there are communi- 
cations problems. This message is usually associated with a cable that does 
not meet the specifications. Presented in IBM 71 71 ASCII Device Attach- 
ment Control Unit Description and Planning Guide. The initial transmission 
will not begin until CTS and DSR are presented. Hexadecimal status is 
BIOS INT 14h status for diagnostic information only. Redial, try again, then 
check the cabling. 

ABEND DURING ECHOBACK: (buffer data) 

7 17 HO (abend -5) This abnormal end error message appears when there are 
communications problems. In this case, transmission has taken place, 
however, the characters were not echoed. This is an indication that the 
receiving device did not receive the characters, or is unable to echo the char- 
acters back. This is typically a cable related problem. Buffer data is for 
diagnostic information only. Redial, try again, then if the IO fails again, 
check the cable. 

ABEND DURING IORCV: (buffer data) 

7 17 1IO (abend -6) This abnormal end error message appears when there are 
communications problems. Buffer data is for diagnostic information only. 
Redial and try again. 

ABEND DURING IOXMT: (buffer data) 

7 17 1IO (abend -5) This abnormal end error message appears when there are 
communications problems. Buffer data is for diagnostic information only. 
Redial and try again. 

ASYNC BREAK ERROR *** 

7 17 1IO This error message appears when a Break is detected. The commu- 
nications line is probably down or subject to intermittent breaks in satellite 
transmissions. 
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ASYNC FRAME ERROR *** 

7 17 HO This error message appears when there is a Framing error detected. 
The communications line is probably down or subject to problems in satellite 
transmissions. 

ASYNC PARITY ERROR *** 

7 17 HO This error message appears when there is a Parity error detected. 
The parity error may be due to a noisy communications line or loose cable 
connection. Check cables and redial to try to get a cleaner communication 
line. 

AUTOBAUD XMT ERR=nnnn + xxxx 

7 17 HO (abend -2) This error message appears when there are communi- 
cations problems. Hexadecimal status is BIOS INT 14h status for diagnostic 
information only. Redial and try again. 

OVERRUN ERROR *** 

7 17 HO This communications error message appears when Async data is 
being received faster than the PC can process it. There maybe another 
program running in the background as an extension of DOS. If this is the 
case, try again using a lower baud rate, or reboot and do not allow the DOS 
extensions to run in background. 

RCV ERR=nnnn Status= xxxx 

7 17 1IO (abend -6) This error message appears when there are communi- 
cations problems. This error message is usually associated with modem con- 
figurations. The 7 17 1IO utility begins transmission when DSR and CTS are 
presented. Some modems require time, up to 30 seconds, to converge and 
set up for the transmission protocol. The result is the logon information was 
never properly received by the modem at the 7171 connection. If the most 
significant bit of ERR= is set, then attempt the IO a second time, but allow 
sufficient time for the modems to establish a protocol. Each x corresponds 
to a hexadecimal digit such that for ERR, the first byte should equal the Line 
Control Status: 

01 = Data Ready 

02 = Overrun Error 
04 = Parity Error 
08 = Framing Error 
10 = Break Detected 
20 = Transmit Holding Register empty 
40 = Transmit Shift Register empty 
80 = Time Out. 

The second byte of ERR equals the character received. The first byte of 
STATUS equals the Line Control Status, and the second byte equals the 
Modem Status: 

01 = Delta Clear to Send 

02 = Delta data set ready 
04 = Trailing edge ring detector 
08 = Delta receive line signal detect 
10 = Clear to send 
20 = Data set ready 
40 = Ring indicator 
80 = Received line signal detect. 
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UNEXPECTED IBM 7171 RESPONSE: (buffer data) - Expected 'Ok' or 'Error' 

7 17 HO has determined that it is not connected to the ZAP interface. Check 
for a connection to Port and verify that the Maintenance facility password 
is different than the ZAP interface password. Buffer data is for diagnostic 
information only. Try again. 

XMIT = xxxx & ECHO = xxxx 

7 17 HO (abend -5) This error message appears when there are communi- 
cations problems. Each x corresponds to a hexadecimal digit such that for 
XMIT, the first byte should equal 00, and the second byte should equal the 
character that was sent. If the most significant bit of XMIT equals a 1, 
denoting a Time out, then usually the cable does not meet the specifications 
required by the 7171IO utility. The transmission took place, however the 
character was not echoed. See IBM 71 71 ASCII Device Attachment Control 
Unit Description and Planning Guide for help with cable configuration. For 
ECHO, the first byte equals the Line Control Status: 

01 = Data Ready 

02 = Overrun Error 
04 = Parity Error 
08 = Framing Error 
10 = Break Detected 
20 = Transmit Holding Register empty 
40 = Transmit Shift Register empty 
80 = Time Out, CTS and DSR were not seen. 

k The second byte of ECHO equals the character received. 

Note: If XMIT=000D and ECHO=00xx such that xx is the first character 
of the reposition CSS of the terminal last used on this port, then the previous 
session has not been terminated. To terminate the session do one of the fol- 
lowing: 

Keyboard line drop 

Return to Enter Terminal Type from Keyboard 

Force a line drop on the Port 

then attempt the IO again. 

FILE READ or FILE FORMAT ERROR 

7 17 HO PUT This error message appears when 7171IO detects an error 
reading Image file. Relink the file and correct any reported link errors. 

FILE WRITE ERROR 

7 17 HO GET This error message appears when 7171IO detects an error 
writing to an Image file. Retry the 7171IO and write to another disk(ette). 

IOXMIT TIMEOUT ERR; STATUS = xxxx 

7 17 1IO (abend -5) This abnormal end error message appears when there are 
communications problems. Hexadecimal status is BIOS INT 14h status for 
diagnostic information only. Redial and try again. 

J LOGON ABEND: 'Error' expected; Buffer = (buffer data) 

7 17 1IO (abend -3) This abnormal end error message appears when there are 
communications problems. Buffer data is for diagnostic information only. 
Redial and try again. 
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NO ASYNC DATA FOR 5 SECS 

7 17 HO (abend 5) This abnormal end error message appears when there is 
no data received from IBM 7171 for 5 seconds (line is still up). This 
message indicates a possible IBM 7171 problem. 

NO Data Set Ready FOR 5 SECS 

7 17 1IO This error message appears when the modem is not turned on or if 
the user forgot to dialup. Correct the problem and redial. 
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C.16.7 7171 Messages 

The format of the 7171 messages is as follows: 



Reminder Messages 



The utility name appears in capital letters followed by a colon if the message is 
specific to one utility module otherwise there is no utility name. 

A description of the meaning of the message. 



Reminder messages inform the user which data types are valid in a given mode of 
operation. 

Alphanumeric Input Mode 

This reminder appears upon entering data input mode. The valid alphanu- 
meric input characters are 0-9 and A-Z. 

Binary Key Input Mode (see ref manual for details) 

7171TERM: This reminder appears upon entering data input mode. Data 
entry must be the special binary key input described in the manual. 

blank name or "ESC" or "F10" will return to menu 

7171TERM: This reminder appears after the "Enter Filename:" prompt. 
These user escape options may be invoked to break processing and to return 
to the menu. 

CORRECT ANY REPORTED ERRORS BEFORE TUT' IMAGE TO THE 7171 ! 
7171LINK: This reminder appears in the 7171LINK output listing. Correct 
any reported errors before using 7171IO to 'Put' the output image to the 
7171. 

Hex Input Mode: {0 1 ... 8 9 A B C D E F} 

7171TERM: This reminder appears upon entering data input mode. The 
valid hexadecimal input characters are 0-9 and A-F. 

... more [Pg Dn] 

7171TERM: This reminder message appears in multi-page displays. Press 
"Pg Dn" to display the next page of a multi-page display. 

NOTE: IN-PLACE EDIT, MAX LENGTH = 240 CHARS 

7171TERM: This reminder message appears upon entry into the Login Init 
screen. Data entry is in-place and up to 240 characters may be input into the 
space provided. Use the cursor movement keys for editing the string. 

Numeric Input Mode 

7171TERM This reminder appears upon entering data input mode. The 
valid numeric input characters are 0-9. 

Question Input Mode: " Y N " only 

This reminder appears when entering data input mode. 
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Informational Messages 

These messages provide the user with information of utility status: 

7171 LOGOFF: transmitting Exit cmd 

7 17 HO This informational message appears when 7171IO ends its commu- 
nications connection to IBM 7171. No user action/response is required. 

7171 TERMINAL LIST WILL APPEAR AS FOLLOWS: VALID TYPES ARE: 

7171LINK: This informational message appears in the 7171LINK output 
listing. If the terminal types do not appear as desired, correct the .CTL input 
file and relink. 

7171MLNK PROGRAM COMPLETED 

7171MLNK This informational message appears in the 7171MLNK output 
listing. No user action/response is required. 

7171LINK PROGRAM COMPLETED 

7171LINK This informational message appears in the 7171LINK output 
listing. No user action/response is required. 

7171IO PROGRAM COMPLETED 

7171IO This informational message appears in the 7171IO output listing. 
No user action/response is required. 

-TOF- 

7171TERM: This informational message is displayed while editing Input 
Strings when the first input string is located at the top of the display. No 
user action/response is required. 

COM2: will be used for Async i/o"n" 

7 17 HO This informational message appears in the 7171IO output listing if 
the COM2 optional parameter is input to 7171IO. No user action/response 
is required. 

... Connected 

7171IO: This informational message appears in the 7171IO output listing 
when communications are established to the IBM 7171. No user 
action/response is required. 

Dialup/Connect begun ... 

7171IO This informational message appears in the 7171IO output listing 
when beginning/attempting communications connection to the IBM 7171. 
No user action/response is required. 

TML Source file read begun ... 

7171MLNK This informational message appears in the 7171MLNK output 
listing when TML Source file read begins. No user action/response is 
required. 

Enter 8 character Terminal name: 

7171TERM: When this prompt appears, the user must enter the name which 
is to be assigned to this terminal. Only 8 alphanumeric characters may be 
used. This name will display in "Valid Types are:" message. 
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... File closed 

7 17 HO This informational message appears in the 7171IO output listing 
when the Image file is closed. No user action/response is required. 

Get 7171 NV-RAM Size data ... 

7 17 1IO GET This informational message appears in the 7171IO output 
listing when beginning NV-RAM size data receive. No user action/response 
is required. 

Get 7171 Ports data ... 

7 17 HO This informational message appears in the 7171IO output listing 
when beginning Ports data receive. No user action/response is required. 

Get 7171 Term names data ... 

7 17 HO This informational message appears in the 7171IO output listing 
when beginning Term names data receive. No user action/response is 
required. 

Get 7171 User Tables data ... 

7 17 1IO This informational message appears in the 7171IO output listing 
when beginning User Tables data receive. No user action/response is 
required. 

Get Error: 7171 response not 'Ok' 

7 17 1IO GET This informational message appears in the 7171IO output 
listing when there is a problem communicating with the IBM 7171. Redial 
and try again. 

Image file write begun ... 

7171MLNK & 7171LINK: This informational message appears when the 
output Image file write begins. No user action/response, is required. 

Image file write completed 

7171MLNK & 7171LINK: This informational message appears when the 
output Image file is written to disk(ette) and the is closed. No user 
action/response is required. 

LINK PHASE BEGINS ... 

7171LINK This informational message appears in the 7171LINK output 
listing when link processing begins. No user action/response is required. 

LINK PHASE COMPLETED 

7171LINK This informational message appears in the 7171LINK output 
listing when processing is completed. No user action/response is required. 

LOAD COMPLETED 

This message is displayed when a file has been successfully loaded from 
disk(ette) into memory. Press any key to continue. 

Logoff Exit begun ... 

7 17 1IO This informational message appears in the 7171IO output listing 
when beginning a logoff /disconnect from the IBM 7171. No user 
action/response is required. 
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Logoff completed 

Dialup: Okay to hang-up now 

7 17 HO This informational message appears when logoff /disconnect is com- 
pleted. The user may now hang-up a dialed communications line. 

no errors found 

7171LINK This informational message appears in the 7171LINK output 
listing when processing has completed. No user action/response is required. 

Okay to CLEAR Current data? "Yes or No": 

This prompt appears asking if it is alright for this file to replace data cur- 
rently in memory. Answering Yes to this question will cause the current ter- 
minal table information to be overwritten by the new terminal table 
information being read in from disk. Answering No will allow the user to 
perform a Save before reinvoking Load. 

Put 7171 Ports data ... 

7171IO PUT This informational message appears when beginning Ports data 
transmission to IBM 7171. No user action/response is required. 

PASSWORD transmitted 

7171IO This informational message appears in the 717 HO output listing 
when the ZAP password has been transmitted, not necessarily received. No 
user action/response is required. 

Put 7171 User Tables ... 

7171IO PUT This informational message appears in the 7171IO output 
listing when beginning User Table data transmission to the IBM 7171. No 
user action/response is required. 

Reading file: xxxxxxxx ... 

7171IO PUT This informational message appears in the 7171IO output 
listing when beginning an Image file read from disk(ette). No user 
action/response is required. 

READING LOAD FILE ... 

This message is displayed while a file is being read from disk(ette) into 
memory. A completion message will be displayed when the operation is com- 
pleted. No user action/response is required. 

REPORT COMPLETED 

This message is displayed when a report has been successfully printed. No 
user action/response is required. 

SAVE COMPLETED 

This message is displayed when a file has been successfully saved to disk. 
Press any key to continue. 

SAVING FILE ... 

This message is displayed while a file is being saved to disk(ette). A com- 
pletion message will be displayed when the operation is completed. No user 
action/response is required. 
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SYNTAX = 7171IO "Get | Put" "Ports | Terms" filename password "2" 

7 17 HO This informational message appears in the 7171IO output listing if 
7 17 HO detects an input parameter syntax error or after an error which may 
have been caused by a syntax error. Consult the manual for a detailed 
description of the required and optional parameters. 

Syntax: A> 7171MLNK input.tml output.img >listdev - code = -1 

7171MLNK This informational message appears in the 7171MLNK output 
listing if 7171MLNK detects an input parameter syntax error or after an 
error which may have been caused by a syntax error. Consult the manual for 
a detailed description of the required and optional parameters. 

Syntax: A> 7171LINK input.ctl output.img >listdev - code = -1 

7171LINK This informational message appears in the 7171LINK output 
listing if 7171LINK detects an input parameter syntax error or after an error 
which may have been caused by a syntax error. Consult the manual for a 
detailed description of the required and optional parameters. 

Terminal Tables = nnn bytes 
Optimization = nnn bytes saved 
Free space left = nnn bytes 

7171LINK This informational message appears in the 7171LINK output 
listing after processing has completed. The statistics may be used to calcu- 
late the approximate number of additional Terminal Tables which may be 
added to the configuration. No user action/response is required. 

TYPETERM transmitted 

7 17 HO This informational message appears in the 7171IO output listing 
when the Terminal name data has been transmitted, not necessarily received. 
No user action/response is required. 

Writing file: xxxxxxxx ... 

7 17 HO GET This informational message appears in the 7171IO output 
listing when beginning an Image file write to disk(ette). No user 
action/response is required. 

'xxxxxxxx' CTL file scan begun ... 

7171LINK This informational message appears in the 7171LINK output 
listing when control file processing begins. No user action/response is 
required. 

'xxxxxxxx' linked 

7171LINK This informational message appears in the 7171LINK output 
listing for each terminal table linked. No user action/response is required. 

'xxxxxxxx' file load begun ... 

7171LINK This informational message appears in the 7171LINK output 
listing as each .TRM file is loaded. No user action/response is required. 

7 17 1IO triple equal sign is a visual indication that the communications line is 
I clear for transmission. It is seen during 717 1IO connect and disconnect 

* transmission sequences. No user action/response is required. 
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Warning Messages 



CROSS-CHECK: FEAT (Delay) = ms 

7171TERM 7171LINK This warning message appears when at least one 
delay was specified in an output string for a terminal, and the value for delay 
in the terminal features was zero. Input a delay value in the Features screen. 

CROSS-CHECK: FEATURES (Flags) vs OUTPUT (Display Mode) vs GRAPHIC 
7171TERM This warning message appears when one or more of the fol- 
lowing is not specified: Feature Flags highlighting, Display Mode Output 
Sequence, or Graphic Rendition Control String. Either define all three, or 
don't define all three, (no highlighting). 

INCOMPLETE DATA SAVED 

This warning message appears when a file save was not completed due to a 
DOS file write error. Be aware that the output file contains only a part of 
the information which was to be saved. No user action/response is required 
(other than caution). 

INCOMPLETE OR ERRONEOUS DATA LOADED 

This warning message appears when a file read was not completed due to a 
DOS file write error. Be aware that the loaded data contains only a part of 
the information which was to be loaded. No user action/response is 
required (other than caution, particularly in saving the incomplete data back 
to the same file). 

INPUT ERRORS FOUND IN LOAD DATA 

7171TERM This warning message appears when input errors are found in 
load data. Either the file is not formatted as a .TRM file or it contains illegal 
data. Note that the load has completed, but some string data may be 
missing. These errors will only occur if the file is either not a .TRM file 
(wrong file loaded) or if a .TRM file has been edited by a non-7171 utility. 

RESET CHAR(S) FOUND 

7171TERM This warning message appears when one or more reset charac- 
ters is used in an input string. This will result in the string being unusable 
because reset characters have priority over input strings. The user should 
either eliminate the reset character(s) from the input string or redefine the 
reset character(s). 

THIS RESET CHAR FOUND IN ONE OR MORE INPUT SEQ STRINGS 

7171TERM This warning message appears when a character specified as a 
reset character was used in one or more input strings. This will result in 
those strings being unusable because reset characters have priority over input 
strings. Eliminate the reset character from the input string(s) or redefine the 
reset character. 

WARNING: Cursor Origin > 127 

7171TERM This warning message appears when the cursor origin in Ter- 
minal Features exceeds the maximum value allowed. Valid origins must be 
between and 127. Reinput a valid cursor origin. 

WARNING: DELAY > 255 ms 

7171TERM This warning message appears when the delay in Terminal Fea- 
tures is greater than 255 msecs. Normally delay values are between and 
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Error Messages 



255 msecs. The value specified is probably byte reversed. The user should 
either redefine the delay value or ignore this warning (assuming the value IS 
correct). 



nn FATAL ERRORS ENCOUNTERED 

7171LINK This summary error message appears in the output listing. 
Correct all fatal errors before PUT Image to IBM 7171. 

nn FEATURE ERROR(S) FOUND 

7171LINK This error message appears in the output listing. Individual 
error/ warning messages are shown for each error found by 7171LINK. 

nn INPUT SEQ ERROR(S) FOUND 

7171LINK This error message appears in the output listing. Individual 
error/ warning messages are shown for each error found. 

nn LOGIN SEQ ERROR(S) FOUND 

7171LINK This error message appears in the output listing. Individual 
error/ warning messages are shown for each error found. 

nn OUTPUT SEQ ERROR(S) FOUND 

7171LINK This error message appears in the output listing. Individual 
error /warning messages are shown for each error found. 

nn RESET CHAR ERROR(S) FOUND 

7171LINK This error message appears in the output listing. Individual 
error/ warning messages are shown for each error found. 

1st CHAR NOT ASCII CTRL CHAR 

7171TERM The first character of all usable input strings must begin with a 
valid ASCII control character (00- IF). The first character of the specified 
input string is not valid. Redefine the input string. 

7171MLNK: error opening 'xxxxxxxx' input file 

7171MLNK This error message appears in the output listing when the 
named input file is not found or, rarely, if there is a disk(ette) i/o error. 
Reinvoke 7171MLNK with the input file parameter naming an existing file 
and be sure the diskette drive and (sub) directory are correct. 

7171MLNK: error opening 'xxxxxxxx' output image file 

7171MLNK This error message appears in the output listing when a 
disk(ette) directory is full,does not exist, or, rarely, if there is a disk(ette) i/o 
error. Reinvoke 7171MLNK with the output file parameter naming an 
another file and be sure the diskette drive and (sub) directory are correct. If 
writing to a diskette, check it for a write-protect tab. 

7171MLNK ABEND: *> DOS FILE ERROR WRITING IMAGE FILE * - code = 
nn 

7171MLNK This abnormal end error message appears when 7171MLNK 
terminates due to a DOS file error. If writing to a diskette, check it for a 
write-protect tab. 
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7171LINK ABEND: CONTROL FILE SCAN ERROR - code = nn 

7171LINK This abnormal end error message appears in the output listing 
when the control file does not have the correct format and/or the control file 
contains invalid data. Consult the manual for the correct format and re-edit 
the .CTL file before relinking. 

7171LINK ABEND: *> DOS FILE ERROR WRITING IMAGE FILE * - code = 
nn 

7171LINK This abnormal end error message appears in the output listing 
when 7171LINK terminates due to a DOS file error. If writing to a diskette, 
check it for a write-protect tab. 

7171LINK ABEND: LINK PHASE ERRORS - code = nn 

7171LINK This summary error message appears in the output listing. The 
user must correct all errors before PUT Image to IBM 7171. 

7171LINK: error opening 'xxxxxxxx' input file 

7171LINK This error message appears when the named input file is not 
found or, rarely, if there is a disk(ette) i/o error. Reinvoke 7171LINK with 
the input file parameter naming an existing file and be sure the diskette drive 
and (sub)directory are correct. 

7171LINK: error opening 'xxxxxxxx' output image file 

7171LINK This error message appears in the output listing when a disk(ette) 
directory is full, does not exist, or, rarely, if there is a disk(ette) i/o error. 
Reinvoke 7171LINK with the output file parameter naming an another file 
and be sure the diskette drive and (sub)directory are correct. If writing to a 
diskette, check it for a write-protect tab. 

-EOF- ALL STRING SEQ USED: NO MORE ROOM FOR APPENDS 

7171TERM This error message appears when the maximum allowable 
number of input strings has been entered. There is no room to add more 
input strings without deleting previous strings. 

NV-RAM OVERFLOW - TOO MANY TERMINALS 

7171LINK This error message appears in the output listing when 7171LINK 
determines that the output Image would overflow NV-RAM. Relink using 
fewer terminals in .CTL file or decrease the number and/or length of strings 
in one or more terminal tables. 

DOS FILE ERROR ENCOUNTERED 

This error message is displayed when an error is encountered while reading 
or writing to a disk(ette). The operation did not complete successfully. If 
writing to a diskette, check it for a write-protect tab. 

DOS FILE ERROR ENCOUNTERED: INCOMPLETE REPORT 

This error message appears when there is a printer error or a file save was 
not completed due to a DOS file write error. If writing to a diskette, check it 
for a write-protect tab. 

ERROR OPENING ... 

This error message appears when an error was encountered attempting to 
open a specified file. This may be because the file does not exist on the 
specified drive. Reinvoke with the file name spelled correctly and be sure 



C-74 IBM 7171 Reference Manual and Programming Guide 



the diskette drive and (sub)directory are correct. If writing to a diskette, 
check it for a write-protect tab. 

ERROR: ONE OR MORE GRAPHIC CHARS NOT 7-BIT ASCII 

7171TERM This error message appears when one or more Graphic Rendi- 
tion Control characters are invalid. All Graphic Rendition Control charac- 
ters must be valid ASCII characters (00-7F). Redefine the invalid 
character (s). 

FATAL ERROR LOADING: GRAPHIC RENDITION CHARS 

7171LINK This error message appears when IBM 7171LINK detects an 
error during a file load. Relink after editing Graphic Rendition Control 
Stringin7171TERM. 

FATAL ERROR LOADING: INPUT STRINGS 

7171LINK This error message appears when 7171LINK detects an error 
during a file load. Relink after editing Input Strings in 7171TERM. 

FATAL ERROR LOADING: LOGIN STRING 

7171LINK This error message appears when 7171LINK detects an error 
during a file load. Relink after editing Login Init Sequence in 7171TERM. 

FATAL ERROR LOADING: MORE DATA THAN EXPECTED 

7171LINK This error message appears when 7171LINK detects an error 
during a file load. The .TRM file format is bad. Relink after saving from 
7171TERM. 

FATAL ERROR LOADING: OUTPUT STRINGS 

7171LINK This error message appears when 7171LINK detects an error 
during a file load. Relink after editing Output Sequences in 7171TERM. 

FATAL ERROR LOADING: RESET CHARS 

7171LINK This error message appears when 7171LINK detects an error 
during a file load. Relink after editing Reset Characters in 7171TERM. 

FATAL ERROR LOADING: TCD DATA 

7171LINK This error message appears when 7171LINK detects an error 
during a file load. Relink after editing Terminal Features in 717 1TERM. 

FATAL ERROR LOADING: TERMINAL NAME 

7171LINK This error message appears when 7171LINK detects an error 
during a file load. The .TRM file format is bad. Relink after saving from 
IBM7171TERM. 

ILLEGAL CHAR(S) FOUND 

7171TERM This error message appears when one or more characters are 
greater than 80 hex and are not valid special 8-bit control characters 

(bin x, char x, etc.). Legal characters are 7-bit ASCII (00-7F) and the 

special 8-bit control characters. 

Insert error - Press "Ins" key 

This error message is displayed when an input area is full and characters are 
being entered while in insert mode. Press the "INS" key to exit insert mode 
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INVALID BAUDRATE 

7171TERM This error message appears when a baud rate is entered which is 
not one of the allowable values. The valid baud rates are listed on the Con- 
figure 7171 Ports screen. 

INVALID TERMTYPE: xxxxxxxx 

IBM 7171TERM This error message appears when the terminal name 
xxxxxxxx is not found in the TERMTYPS list in the Image file which was 
loaded. Refer to the Link output listing for the list of valid terminal types. 

NO TERMINAL NAMES IN IMAGE 

7171PORT This error message appears when a file is either not an Image file 
(wrong file loaded) or is the output of a bad link. If this is output from a 
TML Link, there is no TERMTYPS statement in the TML source. 

NO TERMTYPS FOUND - IS YOUR CONTROL FILE EMPTY ? * 

7171LINK This error message (not a prompt) appears when there are no 
terminal tables specified in the input control file. Re-edit the control file and 
then relink. 

ONE OR MORE PARAMETERS NOT SPECIFIED 

7171 & 7171TML This error message appears when there is an error loading 
the 7171IO or 7171MLNK sub utilities. The user did not specify one or 
more required parameters. Return to the screen and input ALL required 
parameters. 

RESET CHAR MUST BE AN ASCII CTRL CHAR 

7171TERM This communications error message appears when the value 
specified is not a valid Reset character. All Reset characters must be ASCII 
control characters (00- IF). Redefine the invalid Reset character. 

TOO MANY TERMTYPS, MAX = nn * 

7171LINK This error message appears in the output listing when the 
7171LINK TERMTYPS table overflows. Relink using fewer terminals in 
the input .CTL file. 

xxxxxxxx DUPLICATE TERMINAL NAME LINKED - non-fatal error, processing 
continues 

7171LINK This error message appears in the output listing when a terminal 
table has the same terminal name as a previously linked table. The output 
image MAY be partially usable, but only the first terminal table will be 
accessible (the duplicate (s) will not be accessible). 
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C.17 IBM 7171 Terminal Macro Language for Generating Terminal 
Tables 

The Terminal Macro Language Support Utility is invoked by issuing "7171TML" 
on a DOS command line. After 7171TML is entered, the user is free to select the 
sub utility of choice. 



7171 TML 



I 
MPRT 



MAIN (71 71 TML) 
I 



I 
TML REPORT 



EDIT . TML 



I I 
MLINK I/O 



Figure C-34. Calling Tree of IBM 7171 TML Support Functions 

1 . [x:]7 1 7 1TML [drive: [\path]] 



Executing this command invokes the Menu Driven support for TML table 
generation. 

'x' is the disk(ette) drive where 7171TML resides. 

'drive' is where the utilities called by 7171TML reside, refer to the calling 
tree. 

'path' is the DOS pathname to the directory containing the utilities and 
data files. 



2. 7171MPRT filename 1 [.PRO] filename2[.IMG] [>device] 

• Executing this command invokes the Support Utility for updating the ports 
configuration using filenamel.PRO source statements and applying the 
profile to filename2.IMG. Default filetypes will be filled in if no file exten- 
sion is given. 

• > device redirects the output from the user's screen to the device specified. 
The device typically will be one of the following: PRN | filename.ext 

3. 7 17 HO {Get | Put} {Ports | Terms} filename.IMG [password [2]] 

• Executing this command invokes the IBM 7171 Support Utility which 
inputs or outputs .IMG files into or out of the IBM 7171. 

• Either 'G' or 'P' must be entered in the place of Get or Put depending on 
the action desired. 

• Either 'P' or 'T' must be entered in the place of Ports or Terms to specify 
the information which is to be moved. 
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• The optional 2 can be used to specify COM2 for communications instead 
of the default, which is COM1. 

• The minimal command requires, get or put, ports or terms, and the image 
filename. Other parameters will be defaulted unless specified. Default 
ZAP password is @@ZAP@@, and default COM port is COM1. 
TYPETERM must be a valid terminal type. 

4. 7171MLNK filename[.TML] filename[.IMG] [>device] 

• Executing this command invokes the IBM 7171 Support Utility which per- 
forms the linking of all the terminal definitions specified in the .TML file. 

• > device redirects the output from the user's screen to the device specified. 
The device typically will be one of the following: PRN | filename.ext 



C.17.1 Terminal Macro Language 



The Terminal Macro Language file is created using a text editor such as EDLIN or 
the IBM Personal Editor. Use an extension of .TML for the Macro Language files. 
Specifically allowable IBM 7171 Macro Language statements are those found in 
the IBM Manual SB30-191 1 IBM Series/ 1 Yale ASCII Terminal Communication 
System II Program Description/ Operations Manual (including TNL SN60-1215 of 
9/15/83) with the limitations discussed below. Once all the terminal tables are 
defined they are linked together into a IBM 7171 loadable .IMG file using the 
MLNK function. The following macro statements are emulated: 

TERMTYPS 

EADSTERM ORIGIN= HTRAN= TTRAN= DELAY= RCHRS= SGR= 
FLAGS= 

EADSCSS EQU= 

EADSNODE CALL GOTO PARM= 

label EQU * & another label (including ROM vector names) 
END (logical e-o-f for assembler source) 
Error messages will be generated by MLNK for the following parms: 
PAD= 
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C.18 TML Syntax Templates 



This describes the general syntax for TML statements. 
TML statements may be: 

• 1 or more lines in length 

• Line lengths are up to 80 bytes 

• Statement lengths may be up to 350 bytes 

• Statement extension is possible through the keyword CONTINUE 



label macro parms comments 

* comment line 



Figure C-35. TML Syntax Template 

• LABEL 



Depending on the macro, label may be required or optional. 

Labels always begin in column 1. 

Labels are terminated by a space or tab. 

Maximum Label length is up to 13 characters. 

Label names are converted to uppercase during processing. 



MACRO 



— Identifies the macro which will be used. 

— The Macro name is separated from the label by a space, tab. 

— The maximum length of a macro name is 8 characters. 

— The macro name is converted to uppercase for processing. 

PARMS 

— Depending on the macro, this field may not be required. 

— Parms are separated from a Macro name by a space, tab, or a comma. 

— The parm list is terminated by a space, tab, or eol. [eol] is a constant 
denoting the end of a line, CR, LF. 

— The maximum length of a parm list is 52. 

— Individual parms are separated by a comma. 

— Quoted strings may be parms if delimited by single quotes, ' ' and may 
contain lowercase characters which will be processed as lowercase. 

— Unquoted parms are converted to uppercase during processing. 

COMMENT 

— This field is optional and is separated from PARMS by a space, or a tab. 

— Comment fields are terminated by the eol. 

— The comment field will prevent line continuation. 

— The comment field is ignored during processing. 
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COMMENT LINES begin with a STAR in column 1 and may appear any- 
where. 
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C.19 Macro Syntax 



Each of the macro statements in the following sections has its syntax described 
according to the following conventions: 

• Words in capital letters are keywords and must be entered as shown. They 
may be entered in any combination of uppercase and lowercase. TML con- 
verts words to uppercase, except when they are part of a quoted string. 

• Items in square brackets, [ ], are optional. 

• An ellipsis indicates that an item may be repeated, provided rules with 

respect to length and syntax are observed. 

• The | denotes a choice between the item before and after it. 

• Uppercase letters and punctuation marks other then those described above, 
represent information which must appear exactly as shown. 



C.19.1 MACRO Support Utilities 



1 . 717 1MPRT supports the PORT MACRO which is used for redefining port 
configurations, default file extension is .PRO, Ports Profile. 



2. 7171MLNK supports macros for defining terminal definition tables, default file 



' extension is .TML, Terminal Macro Language. 
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C.19.2 7171MPRT PORT Macro 





Defaults: 


PORT portno 




[ , FLAGS=X ' hhhh ' ] X'1A00' 




[ , BAUD=baudr a t e ] Autobaud 




[ ,BIND=tname] Enter Terminal Type Prompt 




[,LIST=tname] list at x'0300' 


The meaning 


of each field is described below: 


PORT 


The Macro ' s name 


portno 


Is the decimal value of the port, 0-63. 


FLAGS 


Allows the flags to be changed from the default X'lAOO 1 




to X ' hhhh ' . 


BAUD 


Allows the port to be bound to a specific baud rate 




if baud=0 then autobaud will be used 


BIND 


Allows tname to be bound to the port at line connect time. 




Default, 0, is prompt the port. 


LIST 


Specifies which sublist to use for the ENTER TERMINAL TYPE 




messages VALID TYPES ARE list. By specifying any terminal 




name in a sublist will select that sublist. 



Figure C-36. PRO PORT Syntax 
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C.19.3 7171MLNKTERMTYPS Macro 



[label] 



TERMTYPS 



namel ,name2, ....[+ I - I %] 



The meaning of each field is described below: 

label ignored if present, useful for documentation only 

TERMTYPS The Macro ' s name 

+ A plus results in a CR-LF being sent 

out in the VALID TYPES ARE message. 

A minus results in all terminal names 
within a sublist being hidden from the 
VALID TYPES ARE list. 

% A percent results in the beginning of a new 

terminal names sublist. This is very useful 
for systems which have different Model Groups 
defined by the Sys Gen. 

names 1 ) labels of TERM macros 

2) symbols equated to labels of TERM macros 

3) ROM terminal names. 

Several consecutive TERMTYPS macros may be coded to provide 
control over the display of the ENTER TERMINAL TYPES message. 
All but the last TERMTYPS statement may end with a + 
%, or - character. TYPETERM must be a valid 
terminal type for 717110 to operate. 



Figure C-37. TML TERMTYPS Syntax 



Appendix C. IBM 7171 Support Utility for Modifying Terminal Tables C-83 



C.19.4 7171MLNK TERM Macro 







Defaults: 


[label] TERM inputtab 






[ , outputtab] 


none 




[ , FLAGS=X ' hhhh ' ] 


X'0000' 




[,ORIGIN=ochar] 


X'20' 




[ ,HTRAN=hosttable] 


HTRAN in ROM 




[ , TTRAN=termtable ] 


TTRAN in ROM 




[,DELAY=nnn] 







[ ,RCHRS=stringname] 


RCHS in ROM 




[ , SGR=stringname] 


SGR in ROM 




[ , DPR=decimalnumber ] 


0/24 rows 




[ , DPC=decimalnumber ] 


0/80 columns 




[ ,DLR=decimalnumber] 







[ , DLC=decimalnumber] 







[ , APR=decimalnumber] 







[ , APC=decimalnumber] 







[ , ALR=decimalnumber] 







[ , ALC=decimalnumber] 





The meaning c 


f each field is described below: 




label 


required to assign a symbolic name for TERMTYPS 




only the first 8 characters will be used for TERMTYPS 


TERM 


The Macro ' s name 




inputtab 


1 ) Label of the NODE statement which defines 




the beginning of input parse table 




2) A ROM equate name 




ORIGIN 


Provides a base to be used in generating 




direct cursor addressing strings 






1) Default is X'20' 






2) ORIGIN=0, 0RIGIN=1 is supported after version 1.1 




3) C'x 1 equals any valid ASCII character 


HTRAN 


1 ) label of the user defined Host 

2) A ROM equate name, default 


Translate Tables 


TTRAN 


1 ) Label of the User defined terminal translate table 




2) A ROM equate name (default) 




DELAY 


Specifies in milliseconds, the length 




of the pauses to be inserted into output strings as 




specified in the CSS macros for 


this terminal type 




This is a Decimal Number. 




RCHRS 


1 ) A label of a CSS or DC/DATA statement which defines 




a terminals RCHRS 






2) A ROM Equated name for RCHRS 





Figure C-38 (Part 1 of 2). TML TERM Syntax 
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SGR 1 ) The label of a CSS or DC/DATA statement which defines 
the SGR characters for a terminal 
2) A ROM Equated name for SGR 

FLAGS Keyword provides bit flags which can be set to 
describe special terminal characteristics 
Flag definitions are : 
X'8000' Hardcopy 

X'4000 1 APL / Non-APL terminal (SI/SO) 
X'1000' Bit paired APL terminal 
X'0800 1 Highlighting can be performed 
X'0400 1 Highlighting is a mode 
X'0080' Screen size data included in the TDT 
X'0040 1 Character display in lower right corner 

without scroll 
X'0020 1 Uses 3270 algorithm for nulls on Read Modified 

DPR The decimal number of rows supported by the 

default physical screen size of the terminal. 

DPC The decimal number of columns supported by the 
default physical screen size of the terminal. 

DLR The decimal number of rows supported by the default 
screen size 3270 data stream. 

DLC The decimal number of columns supported by the default 
screen size 3270 data stream. 

APR The decimal number of rows supported by the 

alternate physical screen size of the terminal. 

APC The decimal number of columns supported by the 
alternate physical screen size of the terminal. 

ALR The decimal number of rows supported by the alternate 
screen size 3270 data stream. 

ALC The decimal number of columns supported by the alternate 
screen size 3270 data stream. 



Figure C-38 (Part 2 of 2). TML TERM Syntax 
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C.19.5 7171MLNK CSS Macro 



[label] 


CSS 


charl , char 2, .... 


[label] 


CSS 


EQU=label2 


[label] 
[label] 


CSS 
CSS 


charl , char 2 , [ , CONTINUE] 

[CONTINUE, ] charl , char 2 , . . . 


[label] 
[label] 


CSS 
CSS 


charl ,char2, [,XX] 

[XX,] charl ,char2, . . . 


[label] 


CSS 


charl , char 2, . . . . , 

charn, charm, . . . 


Notice there are several forms of the CSS Macro. 
The meaning of each field is described below: 


label 




Up to 13 characters in length 


CSS 




The Macro ' s name 


chars 
] 


SfOTE: 


May be ASCII equate names (i.e. ESC, LBRACK, . . ) 

May be a Quoted string (i.e. 'LOGON') 

May be a Hexadecimal string (i.e. X'0123 1 ) 

May be a decimal value (i.e. X'10'= 16) 

CSS macros may be up to 32 characters in length 

with the exception of the terminal initialize 

sequence which may be longer. It is the users 

responsibility to be sure the 32 character maximum 

is not exceeded. There will not be an error or 

warning message. 


CONTINUE 


Keyword which continues the CSS definitions 

Last name on one CSS statement and the first name 

on the next 


XX 




A synonym for CONTINUE, the usage is the same 


EQU 




Keyword to points to a CSS which has been defined. 



Figure C-39. TML CSS Syntax 
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C.20 IBM 7171 Support Utility Macro Language Versus Series/1 IUP 

Here is a table which compares the Series/ 1 Macro language to the IBM 7171 
Macro Language. The table is meant to present differences in the two languages as 
well as similarities. A '-' denotes that a specific parameter or statement does not 
have an equivalent. References to the PORTS menu, are there to show where 
unsupported statements can be emulated. 
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Series/1 


7171 Support Utilities 


Comments 


TERMINAL DEVICE=EADS, ADDR=xx 


PORT portno* 


<s/1 specific> 


BITRATE=linspeed 


BAUD=* 


PORTS menu 


ATTN=option 


- 


<s/1 specific> 


LINSIZE=printwidth 


- 


<s/1 specific> 


CODTYPE=ASCII 


- 


<s/1 specific> 


PART=n 


- 


<s/1 specific> 




FLAGS=* 


<s/1 specific> 


EADSLINE PAGESIZ=rows 


PORT portno* 


PORTS menu 


LINESIZ=cols 


- 


PORTS menu 


TYPE=termtype 


BIND=* 


PORTS menu 


XPNT=yes 


- 


not implemented 


LAST=yes 


- 


<s/1 specific> 




LIST=* 




TERMTYPS . . . 


TERMTYPS . . . 




EADSTERM inputtab 


TERM inputtab 




outputtab 


outputtab* 




ORIGIN=ochar 


ORIGIN=ochar 




PAD=(p1,p2,p3,p4) 


- 


<s/1 specific> 


HTRAN=hosttable 


HTRAN=hosttable 




TTRAN=termtable 


TTRAN=termtable 




DELAY=nnn 


DELAY=nnn 




RCHRS=stringname 


RCHRS=stringname 




SGR=stringname 


SGR=stringname 




FLAGS=X 


FLAGS=X 

DPR=decimalnumber* 
DPC=decimalnumber* 
DLR=decimalnumber* 
DLC=decimalnumber* 
APR=decimalnumber* 
APC=decimalnumber* 
ALR=decimalnumber* 
ALC=decimalnumber* 


- 


EADSCSS parml ,parm2, .. . 


CSS parml ,parm2, . . . 




EQU= 


EQU= 




(CHARY) (CHARX) (BINY) (BINX) 


(CHARY) (CHARX) (BINY) (BINX) 




(HARDCOPY) (DELAY) 


(HARDCOPY) (DELAY) 




(CHARFLD) (BINFLD) 


(CHARFLD) (BINFLD) 




(USERY) (USERX) 


(USERY) (USERX) 




EADSNODE char, [CALL I GOTO] ... 


NODE char, [CALL I GOTO] . . . 





* supported in Version 2.0 
Figure C-40. Series/ 1 Syntax and 7171 TML Syntax 
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C.21 TML Syntax Restrictions 



SYNTAX RESTRICTIONS 


EDL 


TML 


TML Error Code 


Maximum line length in bytes 


72 


80 


#101 


Maximum Statement length in bytes 


350 


350 


#103 


Maximum Parms field length in bytes 


350 


64 


#208 


Maximum Label name length in characters 


8 


13 


#104 


Maximum macro name length 


8 


8 


trunc 


Maximum number of labels 


16,383 


256 


#200 


Maximum number of label references 


N/A 


768 


#202 


Continuation Column 


72 


any column 





Figure C-41. A Comparison of EDL and TML 



C.22 TML Pseudo Op Comparison 



PSEUDO-OP 


EDL ASSEMBLER 


TML 


DC 


8 characters (max) 


64 characters (max) 


DATA 


yes 


yes -enhanced 


EQU 


yes 


yes 


END 


yes 


yes 


EJECT 


yes 


no 


SKIP 


yes 


no 


TITLE 


yes 


no 


EVEN 


no 


yes 



C.23 Differences and Restrictions 



1 . 7171 MLNK assembles terminal data, and 7171 mprt assembles PORT defi- 
nitions macros. 

2. TERM parameters: 

• Inputtab labels may reference IBM 7171 equate names. 
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• Outputtab labels should be the names of labels associated with TERM 
Macros. 

• PAD=... does not generate data, but will generate a warning message. 

• HTRAN= and TTRAN= default to IBM 7171 ROM translate tables. To 
support customized tables, the table(s) must be defined in the .TML file. 

• DELAY= has the same meaning for the IBM 7171 as for the Series/ 1. 

• ORIGIN^X'OOSorC'c' 

• RCHRS= string has 1 less character (8 vs 9) and the pacing character 
positions are not the same. EDX attention and "PA4" are Series/ 1 spe- 
cific. Also, there is no default RCHRS stringname "EADSRCHRS" - the 
user-defined name must be explicitly coded. 

• SGR= string is identically defined as for the Series/ 1 except that there is 
no default SGR stringname "EADSSGR" - the user-defined name must be 
explicitly coded. 

• FLAGS = bits have the same meanings as for the Series/ 1 except for the 
flag X • 0080 ' for NULLS which is Series/ 1 specific. On the 7171 that bit 
means screen size data is part of the TDT. 

3. CSS strings are limited to 32 bytes, 16 for the Series/1 (PDOM page 3.26.3). 

4. CSS 1st string (Reposition) parameters (USERX) and (USERY) are are sup- 
ported. 

5. CSS 18th string (Display Mode) uses (CHARFLD) (BINFLD) in the same 
manner as for the Series/ 1. 

6. MLNK differences from $EDXASM: 

. TITLE, SKIP, EJECT commands ignored. 

• END is required. 

• DC and DATA statements have been enhanced. 

• EVEN aligns data to the next even address if on an odd address. This 
should precede a block of NODE statements, and TERM statements unless 
memory usage does not allow for free space. 

• The only other (than above) statements supported are: TERMTYPS, 
TERM, CSS, and NODE. 

• LINE CONTINUATION: if the parm field ends with COMMA, EOL. If 
using a mainframe editor, be sure to have RECFM=Variable. Note that 
$EDXASM convention of continuation character in col 72 will be treated 
as a comment and not as a continuation character (see below). 

• COMMENT FIELD: may follow a parm field, and disables line continua- 
tion. 
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• COMMENT LINES: any line beginning with a STAR., '*' is a comment. 

• FIELD DELIMITERS: commas are acceptable between parms, between 
command and parm, and between label and command. 

• PARMS: are delimited by commas and ended by white space or EOL; 
single quotes enclose strings which may contain commas and white space. 

• CAPITALIZATION: except for alpha characters in quoted strings, all 
lower case alpha is converted to upper case. 

• CSS parms may be asciiname, hexstring, decimal number, or CSS (equate) 
as for Series/ 1. 
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C.24 EDL to TML Conversion 



Conversion of EDL files to TML files can be accomplished by doing the following: 

1. Make sure file format is variable record length, variable record length is the 
default in most PC Editors. 

2. Eliminate line numbers in col 73-80. 

3. Search for continuation chars in col 72. 

• Eliminate continuation char. 

• Eliminate or move any comment between parms and col 72. If the user 
chooses to move a comment, there are two places the comment may be 
placed: 

— On a separate line with a STAR, ' * ' , in column 1 . 

— In the comment field of the last line of a statement. 

• The continuation line may begin in any column by simply placing a 
COMMA, ',', after the last parm on the line. 

Here is an example of an EDL file before the comment change, and after the 
comment change (2 variations): 



Column # 1 




9 


16 


72 80 


EDL 


label 


macro 


op1 , 
op2, 
op 3 


* commentl $00000001 

* comment2 $00000002 

* comment3 $00000003 


TML 


label 


macro 


op1 , 
op2, 
op 3 


* commentl comment2 comment 3 


TML 


label 
* 

* 


macro 


op1 , 
op2, 
op 3 


commentl 

comment2 
* comment3 



Figure C-42. TML Comments 



All terminal names which equate to ROM terminal names must be changed if 
they are to be redefined in TML. Here are the ROM terminal names and their 
values, see also Appendix D, "Interface for User Supplied Table Modification 
Program" on page D-l of the IBM 7171 Reference Manual and Programming 
Guide, for a ROM listing. 
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7171 


ROM EQUATES 














TERMTYPS 


INPUT 


TABLES 


SPECIAL 


GENERAL 


Addr 


Equate 


Addr 


Equate 


Addr 


Equate 


Addr 


Equate 


8000 


IBM3101 


8035 


IBM3 1011 






8025 


BITMATCH 


8002 


TVI912 


805F 


TVIDI 






802F 


COMSET 


8003 


TVI920 


805F 


TVIDI 






8029 


FUNBPFK 


8004 


TVI950 


805F 


TVIDI 






802B 


FUNCA 


8005 


TVI950R 


8063 


TVII 






802A 


FUNCX 


8006 


ADM31 


8058 


ADM3 1 I 


8032 


ADM 3 1 ATR 


8028 


FUNCPFK 


8007 


ADM3A 


8055 


ADM3AI 


8033 


ADM3 1 MOD 


8071 


HTRAN 


8008 


VT100 


8047 


VT100I 


8053 


VTPFKS 


8022 


QWERTY 1 


8009 


DM1520 


803C 


DM1 5201 






8023 


QWERTY 2 


800A 


DM1521 


803C 


DM1520I 






8024 


QWERTY 3 


800B 


DM3045 


8040 


DM3045I 


8031 


DM3SGR 


8021 


RCHRS 


800C 


TYPETERM 


806A 


TPTMI 






802C 


RSETCHAR 


800D 


HARDCOPY 


806D 


HCPYI 






802D 


SETCHAR 


800E 


PLOTTER 


806D 


HCPYI 






802E 
8030 
8026 
8070 


SETMTCH 
SGR 

TYPPFK 
TTRAN 



Figure C-43. ROM Equates 



5. Change EADSTERM statements to TERM. 

• Outputtab positional parm not supported in TML versions 1.02,1.03, and 
1.1. 

• Outputtab positional parm is supported in TML version 2.0. 
. ORIGIN= default is X ' 20 ' . 

. HTRAN=,TTRAN=,SGR=, RCHRS = default to ROM equates, user 
override allowed, see Appendix D, "Interface for User Supplied Table 
Modification Program" on page D-l. 

• FLAGS=X'0080 I &X'0010' not supported on 7171 as on the Series/1. 
X ' 0080 ' indicates screen size definitions are part of the TDT. 

• PAD= not supported on 7171, will generate a warning. 

6. Change the EADSCSS statements to CSS. 

7. Change the EADSNODE statements to NODE. 

8. Change the RCHRS statements to the 7 17 1 definition. 

9. Change the ASCII mnemonics as directed here: 



Change TAB to HT 
Change ENQ to WRU 
Change LINEFEED to LF 
Change FORMFEED to FF 
Change DC 1 to XON 
Change DC3 to XOFF 
Change ESCAPE to ESC 
Change BLANK to SPACE 
Change ASTERISK TO STAR 
Change HYPHEN to MINUS 



Appendix C. IBM 7171 Support Utility for Modifying Terminal Tables C-93 



• Change DOT to PERIOD. 

Note: See Figure C-45 on page C-97 for valid ASCII names. 

10. Change "CSS ," to "CSS NONE" or "CSS EQU=CSNONE" which assumes 
there is a line somewhere else as follows: 
CSNONE CSS NONE 
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C.24.1 TML Example 



THE TERMINAL NAMES LIST 



TERMTYPS IBM3101 , IBM3 1 02 , VT1 00, - 
TERMTYPS TYPETERM 

* TYPETERM IS THE LAST VALID TERMINAL TYPE. 

* IS CONTINUED BY USING COMMAS. 
* 

EVEN 
IBM3102 TERM IBM31 01_I ,ORIGIN=X' 20 ' ,FLAGS=X ' 0000 ' , 

SGR=IBM3 1 1_SGR, RCHRS=IBM3 1 1_RCHRS , DELAY=1 



THESE 19 CSSs WILL BE SENT TO THE TERMINAL AS OUTPUT 



CSS ESC,Y, (BINY) , (BINX) 
CSS ESC, I 
CSS ESC,W 
CSS BEL 
CSS BS 
CSS ESC,C 
CSNONE CSS NONE 

CSS EQU=CSNONE 

CSS EQU=CSNONE 

CSS EQU=CSNONE 

CSS 'disconnected — ' 

CSS ESC,L 

CSS ESC,L 

CSS COLON 

CSS EQU=CSNONE 

CSS EQU=CSNONE 

CSS EQU=CSNONE 

CSS EQU=CSNONE 

CSS EQU=CSNONE 



1 REPOSITION 

2 ERASE TO END OF LINE 

3 LOCAL PRINT 

4 TONE 

5 CURSOR LEFT 

6 CURSOR RIGHT 

7 NOT USED 

8 NOT USED 

9 SIGNAL INSERT MODE ON 

10 SIGNAL INSERT MODE OFF 

1 1 DISCONNECT 

12 CLEAR SCREEN 

13 TERMINAL INITIALIZE 

14 ILLEGAL ASCII 

15 ILLEGAL APL 

16 APL CHARACTERS ON 

17 APL CHARACTERS OFF 

18 DISPLAY MODE 

19 NOT USED 



* THESE ARE THE RESET CHARACTERS 
* 

* PRESS CTRL - GRTXQSW 
IBM3101_RCHRS CSS NONE, BEL, DC2 ,DC4 , CAN, XON,XOFF, ETB 
* 

* THESE ARE THE SGR STRINGS PRIMARY AND ALTERNATE 
* 

IBM3101_SGR DC X ' 000001 0001 000001 0001 ' 

PAKEYS CSS Z,X'01 ' ,LCZ,X'01 * ,X,X'02' ,LCX,X'02' ,C,X'03' ,LCX,X*03' 

♦HERE IS THE INPUT PARSE TABLE 
* 

Even 
IBM3101_I EQU * 

NODE ESC, GOTO, NODE01 

NODE BS, CALL, ENTER ENTER = BS 

NODE HT, CALL, TAB TAB = HT 

NODE VT,CALL,DPFM,DUP 

NODE FF,CALL,DPFM,FM 

NODE CR,CALL,NL 

NODE SYN,CALL,RESHOW 

NODE DEL, CALL, DELETE 

NODE SEQENDER,GOTO,* 



Figure C-44 (Part 1 of 2). TML Example 
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NODE 01 


EQU * 




NODE J,GOTO,NODE02 




NODE HT , CALL , COLTAB COLTAB=ESC , HT 




NODE CR,CALL,COLBAK COLBAK=ESC,CR 




NODE A, CALL, UP 




NODE B, CALL, DOWN 




NODE C, CALL, RIGHT 




NODE D, CALL, LEFT 




NODE H, CALL, HOME 




NODE I,CALL,EEOF 




NODE K,CALL,CURSEL 




NODE L, CALL, CLEAR 




NODE W,CALL,LPRT 




NODE SEQENDER,GOTO,* 


NODE02 


EQU * 




NODE HT,CALL,BTAB BTAB =ESC,J,HT 




NODE ESC,GOTO,NODE03 


* 


NODE ACCENT, GOTO, NODE04 




NODE MATCH, GOTO, PAKEYS 


* 


NODE NULL, CALL, ATTN 




NODE DEL , CALL , INSRT 


* 


NODE OTHERS , GOTO , TYPPFK * THIS IS A ROM LABEL 


* LOOK 


IN APPENDIX E FOR THIS SOURCE. THE LIST OF VALID 


* ROM LABELS CAN BE FOUND IN FIGURE C-44 . 


NODE03 


EQU * 




NODE A, CALL, INDENT 




NODE B , CALL , UNDENT 




NODE C, CALL, COLTAB 




NODE D,CALL,COLBAK 




NODE K,CALL,EINP 




NODE W,CALL,TREQ 




NODE SEQENDER,GOTO,* 


NODE04 


EQU * 




NODE ESC,GOTO,NODE05 




NODE CR,CALL,SETMRG 




NODE OTHERS , GOTO , COMSET * ANOTHER ROM LABEL 




NODE SEQENDER,GOTO,* 


NODE05 


EQU * 




NODE H , CALL , SETHOM 




NODE L,CALL,CLRTAB 




NODE SEQENDER , GOTO , * 




END * 



Figure C-44 (Part 2 of 2). TML Example 
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C.25 MLNK Mnemonics 



00 NULL 


20 


SPACE 


40 


AT 


60 


ACCENT 


01 SOH 


21 


EXCLAIM 


41 


A 


61 


LCA 


02 STX 


22 


DQUOTE 


42 


B 


62 


LCB 


03 ETX 


23 


POUND 


43 


C 


63 


LCC 


04 EOT 


24 


DOLLAR 


44 


D 


64 


LCD 


05 WRU 


25 


PERCENT 


45 


E 


65 


LCE 


06 ACK 


26 


AND 


46 


F 


66 


LCF 


07 BEL 


27 


QUOTE 


47 


G 


67 


LCG 


08 BS 


28 


LPAREN 


48 


H 


68 


LCH 


09 HT 


29 


RPAREN 


49 


I 


69 


LCI 


0A LF 


2A 


STAR 


4A 


J 


6A 


LCJ 


OB VT 


2B 


PLUS 


4B 


K 


6B 


LCK 


OC FF 


2C 


COMMA 


4C 


L 


6C 


LCL 


OD CR 


2D 


MINUS 


4D 


M 


6D 


LCM 


OE SO 


2E 


PERIOD 


4E 


N 


6E 


LCN 


OF SI 


2F 


SLASH 


4F 





6F 


LCO 


10 DLE 


30 


so 


50 


P 


70 


LCP 


11 XON 


31 


ai 


51 


Q 


71 


LCQ 


12 DC2 


32 


32 


52 


R 


72 


LCR 


13 XOFF 


33 


33 


53 


S 


73 


LCS 


14 DC4 


34 


34 


54 


T 


74 


LCT 


15 NAK 


35 


35 


55 


U 


75 


LCU 


16 SYN 


36 


36 


56 


V 


76 


LCV 


17 ETB 


37 


37 


57 


W 


77 


LCW 


18 CAN 


38 


38 


58 


X 


78 


LCX 


19 EM 


39 


39 


59 


Y 


79 


LCY 


1A SUB 


3A 


COLON 


5A 


Z 


7A 


LCZ 


1B ESC 


3B 


SEMI 


5B 


LBRACK 


7B 


LBRACE 


1C FS 


3C 


LESS 


5C 


BSLASH 


7C 


BAR 


1D GS 


3D 


EQUAL 


5D 


RBRACK 


7D 


RBRACE 


1E RS 


3E 


GREATER 


5E 


UPARROW 


7E 


TILDE 


1F US 


3F 


QUESTION 


5F 


UNDER 


7F 


DEL 



Figure C-45. ASCII Character Name Table 
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C.25.1 Function Name Table 



The following table gives a unique name to each function that can be invoked by 
pressing a key or key sequence on the keyboard of an ASCII terminal. The 3270 
and IBM 7171 extended functions correspond to internal IBM 7171 names of sub- 
routines which will be called from the input parse table to execute those particular 
functions. Figure C-46 lists these internal names, together with a more descriptive 
function notation. 



Routine 


Routine 


Routine 


Number 


Name 


Description 


X'08' 


LPRT 


Echoback Local Print Sequence 


X'13 1 


DPFM 


Special Character (DUP or FIELD MARK) 


X'11 ' 


CURSEL 


Cursor Select (emulate light pen) 


X'OE' 


RE SHOW 


Redisplay Screen Contents 


X'12' 


EINP 


Erase Input 


X'OC 


EEOF 


Erase EOF 


X'09' 


DELETE 


Delete Character 


X'07' 


INSRT 


Toggle Insert Mode 


X'OA' 


TAB 


Field Tab 


X'OF' 


BTAB 


Field Backtab 


X*1C" 


COLTAB 


Column Tab 


X' 1D 1 


COLBAK 


Column Backtab 


X"1E' 


INDENT 


Indent 


X' 1F 1 


UNDENT 


Undent 


X'02' 


ATTN 


Attention Generating 

(needs parameters for: 
ENTER, CLEAR, PF1 - PF36, PA1 - PA3 , TREQ) 


X'OB' 


NL 


Newline 


X'OD' 


HOME 


Home 


X'05' 


UP 


Cursor Up 


X'06' 


DOWN 


Cursor Down 


X'04' 


RIGHT 


Cursor Right 


X*03' 


LEFT 


Cursor Left 


X"I7' 


SETTAB 


Set Column Tab 


X'1A* 


DELTAB 


Delete Column Tab 


X'19' 


SETMRG 


Set Left Margin 


X*1B' 


SETHOM 


Set Home Line 


X' 18' 


CLRTAB 


Delete All Column Tabs, Home Line, and Left Margin 


X'20' 


SET 


Set Mode of Operation (needs parameters for: 

z, n, e, c, v, d, i) 


X'21 ' 


RESET 


Reset Mode of Operation (needs parameters for: 

Z, N, E, C, V, D, I) 


X'14' 


APLON 


APL Mode On 


X'16' 


APLOFF 


APL Mode Off 


X'15' 


APLEND 


ASCII Input in APL Mode 


X'22' 


PCON 


Restore Pacing 


X'23' 


PCOFF 


Suppress Pacing 


X'25' 


DISC 


Keyboard Initiated Line Drop 


X'26' 


INIT 


Return to ENTER TERMINAL TYPE Message 


X'27' 


ALTK 


Alternate Keyboard Arrangement 


X'28' 


MULT 


Multiple Key Input Sequence to Graphic Character 


X*2C 


RUBOUT 


Destructive Backspace 


X'2F' 


PGUP 


Page up on Logical Screen 


X'30' 


PGDN 


Page down on Logical Screen 


X'10' 


DEFER 


Deferred Key Execute 



Figure C-46. Function Name Table 
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C.26 MLNK Error Code Conventions 



= END statement not coded 



Fatal errors terminate processing. 

Non-fatal errors may terminate processing of the current line or statement, but 
processing will continue with the next line or statement. 

Negative codes are fatal errors. 

Positive codes are non-fatal errors. 

-100 = Unexpected end-of-file 

101 = Input line truncated 

102 = Label on continuation line 

103 = Statement too long 

104 = Too many fields in statement > 52 operands 

105 = Unmatched quotes 

106 = Required fields missing 

200 = Label table overflow 

201 = Duplicate label 



> 350 bytes 



> 256 label definitions 



202 = Reference table overflow 

203 = Unresolved reference(s) 

204 = Unrecognized command 



Remember, ROM equate names are 
labels, if the user uses the same name, 
they become duplicate labels. 

> 768 label references 

= undefined label(s) 

YALE MACRO statement not sup- 
ported 



205 = Core buffer full 

206 = Invalid operand 

207 = Unmatched quote 

208 = Operand too long > 64 bytes 

209 = Invalid digit 

210 = Odd number of digits in hex string 

211 = Operand missing 

212 = Label required 



> 8K NV-RAM exceeded 
The Syntax was not recognized 
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213 = Invalid label reference 

214 = Last terminal missing CSS string(s) Each TERM statement should be 

followed by 19 CSS statements 

215 = 'EQU=' parm on continued CSS statement 
### = Unrecognized error (shouldn't happen) 



C.27 The Support Utility Using DOS Bat files 



Some tasks which the Support Utility performs do not require a high degree of user 
interaction. Since this is true, these utilities can be run from the DOS command 
line by just supplying the few parameters required. In particular 7171LINK, 
7171MLNK, and 7171IO, can be run from the command line or DOS BAT files. It 
is recommended the user takes advantage of the DOS BAT files and let DOS and 
the Support Utility do the work. 



C.27.1 Command Syntax Notation 

We will use the following notation to indicate how the 7171 commands should be 
entered: 

| Items separated by a bar ( | ) mean that the user can choose one of the 

separated items. 

{...} Items in ({ }) are required. 

[ 1 Items in square brackets ([ ]) are optional. 

C.27.2 Support Utility Command Syntax 

1. 7171LINKfilename[.CTL]filename[.IMG][>device] 

• Executing this command invokes the IBM 7171 Support Utility which per- 
forms the linking of all the .TRM files specified in the .CTL file. 

• The image file assembled by LINK will be written to filename.IMG. 

• > device redirects the output from the user's screen to the device specified. 
The device typically will be one of the following: PRN | filename. ext | 
CON 

2. 7171MLNKfilename[.TML]filename[.IMG][>device] 

• Executing this command invokes the IBM 7171 Support Utility which per- 
forms the linking of all the terminals specified in the .TML file. 

• > device redirects the output from the user's screen to the device specified. 
The device typically will be one of the following: PRN | filename.ext 
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3. 7171MPRT filename 1 [.PRO] filename2[.IMG] [>device] 

• Executing this command invokes the IBM 7171 Support Utility which per- 
forms the linking port macros into an image file. 

• > device redirects the output from the user's screen to the device specified. 
The device typically will be one of the following: PRN | filename.ext 

• 7 17 1IO {Get | Put} {Ports | Terms} filename.IMG [password [2]] 

— Executing this command invokes the IBM 7171 Support Utility which 
inputs or outputs .IMG files into or out of the IBM 7171. 

— Either 'G' or 'P f must be entered in the place of Get or Put 
depending on the action desired. 

— Either 'P 1 or 'T 1 must be entered in the place of Ports or Terms to 
specify the information which is to be moved. 

— The optional 2 can be used to specify COM2 for communications 
instead of the default, which is COM1. 
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DOS Batch File Example 



ECHO OFF 

ECHO USE CTRL-Break TO QUIT THE BAT FILE. 

ECHO IF YOU WANT A HARDCOPY, USE THE SYSTEM PRINTER BY ENTERING THE 

ECHO FOLLOWING KEYSTROKE 

ECHO CTRL-SHFT-PrtSc 

PAUSE 

ECHO 10. BAT PARAMETERS ARE: 

ECHO P1 "G" OR "P" — GET OR PUT = %'\ 

ECHO P2 "P" OR "T" — PORTS OR TERMS = %2 

ECHO P3 IMAGE FILENAME = %3 

ECHO P4 Bits/second = %4 

ECHO P5 ZAP PASSWORD = %5 

REM INITIALIZE THE COMMUNICATION PORT, C0M1 USED HERE, COM2 IS ACCEPTABLE 

REM IF USING COM2, BE SURE THE 717110 COMMAND BELOW HAS THE REQUIRED 

REM PARAMETERS 

ECHO USE CTRL-BREAK TO EXIT FROM THE BAT FILE IF PARAMETERS ARE WRONG 

PAUSE 

MODE C0M1 :#4,E,7,1 

REM J54 Bits/Second 

REM EVEN PARITY 

REM 7 DATA BITS 

REM 1 STOP BIT 

REM IF THE USER IS USING A MODEM, THE Bits/Second WILL PROBABLY 

REM BE 1200 OR 300. ALSO, THE USER SHOULD DIAL INTO THE IBM 7171. 

REM UNCOMMENT 2 LINES IF USING A MODEM, ALSO FILL IN THE CORRECT NUMBER 

REM ECHO ATD >C0M1 

REM PAUSE 

REM PAUSE GIVES THE MODEM TIME TO DIAL AND ESTABLISH COMMUNICATION 

REM ONLY IF THE USER WAITS A LITTLE WHILE BEFORE STRIKING A KEY 

ECHO USE ALT-NUMLOCK TO HALT SCROLLING, STRIKE ANY OTHER KEY TO CONTINUE 

PAUSE 

717110 951 %2 %3 %5 %6 

:DONE 

ECHO TO STOP THE PRINTER USE THE KEY SEQUENCE CTRL-SHFT-PrtSc 

ECHO ON 

PAUSE 



Figure C-47. Example of IO.BAT 
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Appendix D. Interface for User Supplied Table Modification Program 



D.l Interface Description 



An interface exists for a user supplied table generation program. The interface 
provides defined input and output data streams. The interface may be written for 
any computing device that provides the standard RS-232-C interface that is 
described in Chapter 5, "IBM 7171 I/O Interface to Terminals" of this docu- 
ment. The user may write his own program to utilize this interface. However, the 
user will be responsible for all consequences of using the interface. This program 
will be referred to as the 'User Program' throughout this Appendix. 

The interface is intended to be used to modify, or add Terminal Definition Tables 
that are not supplied with the IBM 7171, or to change the default port configura- 
tion. The following commands are supplied: 

Dump Retrieve data from the IBM 7171 

Compressed Dump Retrieve compressed data from the IBM 7171 

Store Store data to the IBM 7171 

Exit Exit the IBM interface program 



D.2 The IBM 7171 Interface Initialization 



The User Program must first initialize the communications line as described in 
Chapter 5, "IBM 7171 I/O Interface to Terminals." The terminal that runs the 
User Program must be connected to TC port 0, with no other terminals being 
logged on. The IBM 7171 will then present the 'ENTER TERMINAL TYPE:' 
message. The User Program must then present the password '@@ZAP@@' to 
the communications line, followed by a Carriage-Return. The IBM 7171 will then 
prompt again with 'ENTER TERMINAL TYPE:', to which the User Program must 
respond with the terminal type 'TYPETERM', with no Carriage Return. The IBM 
7171 will then respond with the initialization sequence: Carriage Return, Form 
Feed(X'ODOC'). 

All values for storage bytes are byte-reversed as describe in 
Chapter 4, "Customizing IBM 7171 Tables." They are dumped and stored 
exactly as they appear in memory. All values for segments and offsets are not byte 
reversed. The expression '1000' used as an offset is interpreted as 4096 decimal. 
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D.3 Definition of the IBM 7171/User Program Interface 



In the following definitions, this notation applies: 

addr An ASCII representation of a 2 byte address, e.g. 1C00. The digits 

0-9 (ASCII X ' 30 ' - X ' 39 ' ) and the letters A-F (ASCII X ' 41 » - 
X ' 46 * ) are legal. All addresses are offset from segment DC00. 

CRLF The ASCII Carriage Return - Line Feed sequence, i.e. X • 0D0A • 

CR The ASCII Carriage Return, i.e. X ' 0D » 

bytebyte The ASCII representation of any two arbitrary bytes, e.g. 1F43. The 
digits 0-9 (ASCII X ' 30 ■ - X • 39 ' ) and the letters A-F (ASCII X ■ 41 ' 
- X ' 46 ' ) are legal. In the special case where the 'bytebyte' is the 
LAST of a 'one or more'(0 sequence, one or two bytes may be used, 
e.g. 

"S 1C00: 3456 7890" and "S 1C00: 3456 1432 0A3B 78" are 
both legal but "S 1C00: 3456 12 4325" is NOT legal. 

chksum A one byte checksum of all data bytes on the line just issued in 

response to dump commands. One line is defined as the data bytes 
between the second colon and the checksum in a DUMP response. 
The checksum algorithm is given later. 

! One or more of the sequence immediately following the !. The 

sequence may or may not be surrounded by parentheses. 

1 Characters between single quotes are literal ASCII characters. 



D.4 Interface Commands 



The commands are defined as follows: 
1. Exit 

a. Input 

To issue an exit command, enter: 

('E') + (CR) 

b. Output 

The response is 

(CR) + ('Ok') + (CR) 

Followed by the 'ENTER TERMINAL TYPE:' message. 
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Store 

a. Input 

To issue a store command, enter: 

('S') + (' ') + (addr) + (':') + !(• ' + bytebyte) + (CR) 

This takes the bytes represented by the 'bytebytes' and stores them 
sequentially in NV-RAM starting at the given addr. 

b. Output 

(CRLF) + ('Ok') + (CRLF) 

c. Notes: 

1) No input line may exceed 80 characters, including the command and 
the data. 

2) The ZAP program will echo back the entered characters for the store 
command. It is the User Program's responsibility to do a byte by byte 
compare on the echoed data, and the entered data. If they do not 
compare, an invalid ASCII character should be entered in the string, 
the User Program should wait for the Error response, and then re- 
transmit the line. 

3) The interface program is only invoked after a (CR) (ASCII X ' 0D * ) is 
received. Thus, the entire store command is buffered. Placing an 
invalid character in the store string will force an error. The entire 
store string is checked for validity before being executed. Therefore 
inputting an illegal character in the string will cause an error, and no 
data will be stored. 

Compressed Store 

a. Input 

To issue a compressed store command, enter: 

('S') + (' ') + (addr) + (':') + ! (bytebyte) 

This takes the bytes represented by the 'bytebytes' and stores them 
sequentially in NV-RAM starting at the given addr. There is no space pre- 
ceding each 'bytebytes' inputted. 

b. Output 

(CRLF) + ('Ok') + (CRLF) 

c. Notes: 

See notes for Store. 



Appendix D. Interface for User Supplied Table Modification Program D-3 



Dump 

a. Input 

To issue a dump, enter: 

CD') + (' ') + (addr) + ('■) + (addr) + (CR) 

The bytes in NV-RAM, starting at the first addr and ending at the second 
addr, are converted to ASCII format and displayed on the terminal. 

b. Output 

The program will respond with: 

!((':■) + (addr) + (':') + !((' ') + (bytebyte) ) + !(' ') 
+ ('<') + (chksum) + ('>') + (CRLF) ) + ('Ok') + (CRLF) 

Addr is the address of the first byte in the line. Chksum is the checksum 
of the data bytes in the line. 

c. Note 

Because of the size of the internal data buffer, only 32 lines of data will be 
dumped as a maximum, regardless of how much data was requested. If 
more is asked for, the dump will simply terminate early. 

Compressed Dump 

a. Input 

To issue a compressed dump, enter: 

CO + (* ') + (addr) + (■') + (addr) + (CR) 

The bytes in NV-RAM, starting at the first addr and ending at the second 
addr, are converted to ASCII format and displayed on the terminal. 

b. Output 

The program will respond with: 

!((':') + (addr) + (':') + ! (bytebyte) + ('<') 
(chksum) + ('>') + (CRLF)) +5 ('Ok') + (CRLF) 

Addr is the address of the first byte in the line. Chksum is the checksum 
of the data bytes in the line. 

c. Notes 

See note Dump. 
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D.5 Checksum 



Note: In all cases where input is unrecognizable or illegal, the response will be: 

(CRLF) + ('Error') + (CRLF) 

Note: In all cases when a store is attempted and other terminals are logged on, the 
response will be: 

(CRLF) + ('Busy') + (CRLF) 



The checksum provided with the DUMP commands is defined by the following 
algorithm: 

Always ignoring overflow: 
begin 

for (each line dumped) begin 
checksum = 0; 
for (each of 1 to 16 bytes on the line) begin 

checksum = checksum + hex value of storage byte 
end 
output checksum 
end 
end 

So, in the line, 

:1234: 1234 5678 9ABC DEFO 1234 5678 9ABC DEFO <70> 

the checksum is hex 70. And in the line, 

:1234: 01A0 02 <A3> 

the checksum is A3. 

If a checksum problem is found, the dump command should be re-issued. 



D.6 Examples 



Store 

A typical store command would look like: 

S 1234: 54F3 A534 78 

This would store the 5 bytes after the colon in memory starting at location 
1234. 

Dump 

A typical dump command would look like this: 

D 1234 1245 
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And a response might be: 

:1234: 1234 5678 9ABC DEFO 1234 5678 9ABC DEFO <70> 
: 1244: 1234 <46> 

• Compressed Store 

A typical compressed store command would look like: 

S 1234:54F3A53478 

This would store the 5 bytes after the colon in memory starting at location 
1234. 

• Compressed Dump 

A typical compressed dump command would look like this: 

C 1234 1245 

And a response might be: 

: 1234: 1 23456789ABCDEF01 23456789ABCDEF0<70> 
:1244:1234<46> 
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Appendix £. ROM Data Base Organization 



This section describes the IBM 7171 Data Base located in Read-Only Memory and 
lists the source code used to create the contents of the various tables. 

The first 512 bytes of this ROM area are reserved for 256 addresses of tables used 
to define the terminals. A user may access a particular table by correctly coding the 
index. For example, to reference the reset character sequence (RCHS): 

1. Convert the decimal index, 33, to hexadecimal X ' 21 * . 

2. Indicate it is an index by a one in the high order bit, X ' 8021 ' . 

3 . Byte reverse this value X ' 2 1 80 ' . 

Therefore the X ' 2180 ' in a terminal header will reference the reset sequence. 

IBM 7171 ROM Data Base Organization 



FIRST_ROM DS 



0A 

COMMON TERMINALS 
Table Name 
IBM3101 

TVI912 

TVI920 

TVI950 

TVI950R 

ADM31 

ADM3A 

VT100 

DM1520 

DM1521 

DM3045 

TYPETERM 

HARDCOPY 

PLOTTER 

* 

* 

IBM316X 

ROLM3270 



RESERVED 



RESERVED 
RESERVED 



SPARE 



COMMON TABLES / TABLE NAMES 



RCHS 
QWERTY 1 
QWERTY 2 
QWERTY 3 
BITMATCH 



SPARE 



Decimal Index 



1 

2 

3 

4 

5 

6 

7 

8 

9 
10 
11 
12 
13 
14 
15 
16 
17 
18 
19-31 



32 
33 
34 
35 
36 
37 
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TYPPFK 38 

TYPPAK 39 

FUNCPFK 40 

FUNBPFK 4 1 

FUNCX 42 

FUNCA 43 

RSETCHAR 44 

SETCHAR 45 

SETMTCH 46 

COMSET 47 

SGR 48 

DM3SGR 49 

ADM31ATR 50 

ADM31MOD 51 

* RESERVED 52 
IBM3101I 53 
IBM3101_CSS1 54 
IBMESC 55 
IBMESC2 56 
IBMESC3 57 
IBMSET 58 
IBMSET2 59 
DM1 5201 60 
DM1520_CSS1 61 
DMESC 62 
DMSET 63 
DM3045I 64 
DM3045_CSS1 65 
D3ESC 66 
D3ESC2 67 
D3SET 68 
D3SET2 69 
DM3PFKS 70 
VT100I 71 
VT100_CSS1 72 
VTE 73 
VTEE 74 
VTEEO 75 
VTEO 76 
VTEOP 77 
VTEOPE 78 
VTEOPEO 79 
VTSET 80 
VTSET2 81 
VTSET3 82 
VTPFKS 83 

* RESERVED 84 
ADM3AI 85 
ADM3A_CSS1 86 
A3AESC 87 
ADM31I 88 
ADM31_CSS1 89 
ADMNORM 90 
A3 1 ESC 91 
A3 1 SET 92 
A31ESET 93 
A31EESC 94 
TVIDI 95 
TVDSOH 96 
TVSET1 97 
TVSET2 98 
TVII 99 
TVI950_CSS1 100 
TVISOH 101 
TVIESC 102 
TVISET 103 
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TVIPFK1 

TVIPFK2 

TPTMI 

TYPETERM_CSS1 

TPTMESC 

HCPYI 

HARDC0PY_CSS1 

A3ASET 



TTRAN 

HTRAN 

HR77 

HRDA 

HW77 

HWDA 

MSGADDR 

TTRAN 7 E 

VTAMDISC 

HW3278 

HW3278AT 

HW3278ES 

HR3278 

HR3278AT 

HR3278ES 

* 



SPARE 



104 
105 
106 
107 
108 
109 
110 
111 



112 
113 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 



IBM3101+18 




128 


* 


RESERVED 


129 


ADM31+18 




130 


ADM31+18 




131 


TVI950+18 




132 


TVI950R+18 




133 


ADM31+18 




134 


ADM3A+18 




135 


VT100+18 




136 


DM1520+18 




137 


DM1520+18 




138 


DM3045+18 




139 


TYPETERM+18 




140 


HARDCOPY+18 




141 


PLOTTER+18 




142 


* 


RESERVED 


143 


* 


RESERVED 


144 


IBM316X+18 




145 


ROLM3270+18 




146 


* 


SPARE 


147-159 



) 



* 


RESERVED 


160 


* 


RESERVED 


161 


ROLM3270 I 




162 


ROLM3270 RCHRS 




163 


ROLM3270 SGR 




164 


ROLMPFK1 




165 


ROLMPFK2 




166 


IBM316X I 




167 


IBM316X RCHRS 




168 


IBM316X SGR 




169 


NODE 01 




170 


NODE 02 




171 


NODE03 




172 
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ABCDEF 173 

MNO 1 74 

QWERT 175 

NECVDI 1 76 

LNECVDI 177 

N316X1 178 

N316X2 179 

N316X3 180 

N316X4 181 

N316X5 182 

N316X6 183 

N316X7 184 

N316X8 185 

N316X9 186 

NODE34 187 

NODE35 188 

NODE36 189 

NODE37 190 

* SPARE 191-255 

* 

* 
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HOST TRANSLATE TABLE POINTERS 



HTRAN 



EVEN 




EQU 


* 


DC 


HR77 


DC 


HRDA 


DC 


HW77 


DC 


HWDA 


DC 


HW3278 


DC 


HW3278AT 


DC 


HW3278ES 


DC 


HR3278 


DC 


HR3278AT 


DC 


HR3278ES 



HOST READ 3277 

HOST READ APL 

HOST WRITE 

HOST WRITE APL 

HOST WRITE 3278 

HOST WRITE 3278 ATTRIBUTE 

HOST WRITE 3278 APL 

HOST READ 3278 

HOST READ 3278 ATTRIBUTE 

HOST READ 3278 APL 



See Appendix A for the following 
HOST TRANSLATE TABLES for 3277 and 3278 
HR77 
HRDA 
HW77 
HWDA 
HW3278 
HW3278AT 
HW3278ES 
HR3278 
HR3278AT 
HR3278ES 



* 

TTRAN 



See Appendix A for the following TERMINAL 
TRANSLATE TABLES: 



EQU 



NORMAL (NON-APL) ASCII TABLE 
NORMAL ASCII INPUT TRANSLATE TABLE 
TYPEWRITER PAIRED APL TABLE 

TYPEWRITER PAIRED APL INPUT TRANSLATE TABLE 
BIT PAIRED APL TABLE 

BIT PAIRED APL INPUT TRANSLATE TABLE 
* 
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ALTERNATE KEYBOARD 

* REARRANGE GRAPHIC KEYS FOR DVORAK KEYBOARD * 

* 0123456789ABCDEF 

DC X' 00000000000000000000000000000000' 

DC X'00000000000000000000000000000000' 1 

DC X'202122232425262728292A2B772D767A' 2 

DC X'303132333435363738395373573D565A' 3 

DC X'4041584A453E5549444348544E4D4252' 4 

DC X'4C3F504F59474B3C51463A5B5C5D5E5F' 5 

DC X , 6061786A652E7569646368746E6D6272' 6 

DC X'6C2F706F79676B2C71663B7B7C7D7E00 ? 7 

* 0123456789ABCDEF 

* 

* TERMINAL RESET CONTROL CHARACTER SEQUENCES 
* 

* * PERFORM RESET FUNCTIONS * 

* * RESET INTRODUCER (X'FF* = NONE IF NOT USED) * 

* * MASTER RESET * 

* * CHARACTER ERROR RESET * 

* * KEYBOARD UNLOCK (3270 "RESET") * 

* * TYPEAHEAD PURGE * 

* * PACING START * 

* * PACING STOP * 

* * OPERATOR TOGGLE * 

* 

RCHS CSS NONE, BEL, DC2,DC4, CAN, XON,XOFF,ETB 

* CTRL G R T X Q S W 

* SET GRAPHIC RENDITION CODE SEQUENCES 
* 

SGR DC X'00000100' ,X'01000001 ' ,X'0001 ' ANSI X3 . 64 

DM3SGR DC X ' 4F4F4E4F ' ,X ' 4E4E4E4E ' ,X ' 4E4E ' DM3045 

ADM31ATR DC X ' 30303430 ' ,X * 34303030 ' ,X ' 3030 ' ADM31 ATTRBYTE 

ADM31MOD DC X' 28292829 ' ,X' 28282828 *, X ' 2828 ' ADM3 1 MODE 

DC X'00000100' ,X'01373733' ,X'3631 ' (RESERVED) 
* 

* COMMON PROGRAM FUNCTION KEY TABLES 
* 

* * THERE IS A COMMON SET OF TWO KEY FUNCTION * 

* * DEFINITIONS DEFINED ACROSS MOST TERMINALS. * 

* * IT DEFINES A FUNCTION INTRODUCER KEY * 

* * ERASE EOS ON THE IBM 3101 * 

* * ESC ON MOST OTHER TERMINALS * 

* * FUNCT ON THE ADM FAMILY AND ITS FOLLOWERS * 

* * THE SECOND KEY DEFINES THE NATURE OF THE REQUEST * 

* * ON TYPEWRITER PAIRED TERMINALS, THEY ARE * 

* * PFK1-12 FOR THE TOP KEYBOARD ROW 1234567890-= * 

* * PFK13-24 FOR THIS ROW SHIFTED ! 3#$ %-.£*() + * 

* * PFK13-24 FOR THE NEXT ROW QWERTYUIOP * 

* * PFK25-36 FOR ASDFGHJKL; ' * 

* * PA1-3 FOR THE LOWER RIGHT , ./ * 
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* UNSHIFTED QWERTY TYPEWRITER PAIRED TERMINAL * 

* (ANSI X4. 14-1971) ROWS E TO C COLS 00 TO 1 2 * 



QWERTY 1 



CSS ' 1234567890-=' ,XX 

CSS ' qwertyuiop [ ' , BSLASH , XX 

CSS 'asdfghjkl; ' , QUOTE , LBRACE 

* SHIFTED QWERTY TYPEWRITER PAIRED TOP ROW * 



QWERTY 2 



CSS ' !a#$ft' ,UPARROW, AND, '*()_+' 
* SHIFTED QWERTY TYPEWRITER PAIRED MIDDLE ROWS * 



QWERTY 3 



CSS 'QWERTYUIOP] ' , BAR, XX 

CSS ' ASDFGHJKL ; ' , QUOTE , RBRACE 



* ANSI X4.14 BIT PAIRED DIFFERENCES FROM TYPE PAIRED * 



BITMATCH 



CSS DQUOTE , 1 4 , AND ,18, ACCENT ,19, LPAREN , 20 , RPAREN ,21, 

MINUS, 11 ,UPARROW, 1 2 , EQUAL, 23 , TILDE, 24, XX 
CSS AT,23,LBRACK,24,COLON,35,RBRACK,36 

* ANSI STANDARD TYPEWRITER PAIRED ARRANGEMENT * 



TYPPFK 



EVEN 

NODE INDEX , GOTO , QWERTY 1 , PFK 1 

NODE NULL, CALL, ATTN 



NODE INDEX, GOTO, QWERTY 2 , PFK 13 
NODE NULL, CALL, ATTN 



TYPPAK 



NODE INDEX , GOTO , QWERTY 3 , PFK 1 3 
NODE NULL, CALL, ATTN 

NODE COMMA, CALL, PA 1 
NODE LESS, CALL, PA 1 
NODE PERIOD , CALL , PA2 
NODE GREATER, CALL, PA2 
NODE SLASH , CALL , PA3 
NODE QUESTION, CALL, PA3 



NODE SEQENDER,GOTO,* 
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* 

FUNCPFK 



* TYPEWRITER PAIRED FUNCTION TABLE * 

NODE INDEX , GOTO , QWERTY 1 , PFK1 

NODE NULL, GOTO ,FUNCA 

NODE INDEX, GOTO, QWERTY2,PFK1 3 

NODE NULL, GOTO, FUNCA 

NODE INDEX, GOTO, QWERTY 3, PFK 13 

NODE NULL, GOTO, FUNCA 



* 

FUNBPFK 



NODE COMMA, GOTO, FUNCA, PA 1 
NODE LESS, GOTO, FUNCA, PA 1 
NODE PERIOD, GOTO, FUNCA, PA2 
NODE GREATER , GOTO , FUNCA , PA2 
NODE SLASH, GOTO, FUNCA, PA3 
NODE QUESTION, GOTO, FUNCA, PA3 

NODE SEQENDER,GOTO,* 

* BIT PAIRED INTRODUCER SEQUENCE * 

NODE MATCH , GOTO , B I TMATCH , ENTER 
NODE NULL, GOTO, FUNCA 

NODE OTHERS , GOTO , FUNCPFK 
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* * FUNCTION SEQUENCE TERMINATOR FOR LOCAL KEYS * 

* 

NODE CR, CALL, DEFER 
NODE SEQENDER,GOTO,* 
* 

* * FUNCTION SEQUENCE TERMINATOR FOR ATTN KEYS * 

NODE CR, CALL, ATTN 

NODE SEQENDER,GOTO,* 
* 
* 

* 

* COMMON SETUP TABLES 
* 

* 0123456789ABCDEF BIT POSITION IN FLAG WORD 
CSS 'ZNECV DI ' 

CSS ' znecv di ' 

CSS LCP , PCON , P , PCOFF , LCA , APLON , A , APLEND , 

LCM , APLOFF , HT , SETTAB , DEL , DELTAB , 

PERIOD , DISC , COMMA , INIT 
NODE INDEX, GOTO, RSETCHAR 
NODE NULL, CALL, RESET 
NODE INDEX, GOTO, SETCHAR 
NODE NULL, CALL, SET 
NODE MATCH, GOTO, SETMTCH 
NODE NULL , CALL , DEFER 
NODE LCQ , CALL , ALTK , PARM= 1 
NODE Q, CALL, ALTK 
NODE SEQENDER,GOTO,* 
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.*• TERMINAL DEFINITION TABLES (TDT'S) * 

* * 

* IBM3101 DEVICE TABLE * 

* 

EVEN 
IBM3101 TERM IBM3101I 
IBM3101 CSS1 CSS ESC,Y, (BINY) , (BINX) REPOSITION 



CSS ESC, I 
CSS ESC,W 
CSS BEL 
CSS BS 
CSS ESC,C 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS ESC,L 
CSS ESC,L 
CSS COLON 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 



ERASE EOL 
LOCAL PRINT 
TONE 

CURSOR LEFT 
CURSOR RIGHT 

— NOT USED — 

— NOT USED — 
SIGNAL INSERT MODE 
SIGNAL END INSERT MODE 
DISCONNECT 

CLEAR 

TERMINAL INITIALIZE 

ILLEGAL ASCII CHAR 

ILLEGAL APL CHAR 

APL CHARS ON 

APL CHARS OFF 

DISPLAY MODE 

— NOT USED — 



* 
* 

IBM3101I 



* INPUT PARSE TABLE * 

EVEN 

NODE ESC, GOTO, IBMESC 

NODE HT, CALL, TAB 

NODE BS, CALL, ENTER 

NODE CR,CALL,NL 

NODE DEL, CALL, DELETE 

NODE SYN,CALL,RESHOW 

NODE VT,CALL,DPFM,DUP DUP CHARACTER 

NODE FF,CALL,DPFM,FM FM CHARACTER 

NODE SEQENDER,GOTO,* 
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* ESCAPE SEQUENCE TABLE * 



* 

3|C 


****************************♦*****************: 


IBMESC 


NODE 


J,GOTO,IBMESC2 


EEOS 




NODE 


HT,CALL,COLTAB 






NODE 


CR,CALL,COLBAK 






NODE 


A, CALL, UP 


CURSOR UP 




NODE 


B , CALL , DOWN 


CURSOR DOWN 




NODE 


C , CALL , RIGHT 


CURSOR RIGHT 




NODE 


D, CALL, LEFT 


CURSOR LEFT 




NODE 


H, CALL, HOME 


HOME 




NODE 


I , CALL , EEOF 


ERASE EOF/EOL 




NODE 


K,CALL,CURSEL 


ERASE INPUT 




NODE 


L , CALL , CLEAR 


CLEAR 




NODE 


W,CALL,LPRT 


PRINT 




NODE 


SEQENDER,GOTO,* 





* FUNCTION TABLE (FOLLOWING ERASE EOS KEY) * 



IBMESC2 



NODE ESC, GOTO, IBMESC3 

NODE HT,CALL,BTAB FUNCT TAB 

NODE LCZ,CALL,PA1 

NODE LCX,CALL,PA2 

NODE LCC,CALL,PA3 

NODE Z, CALL, PA 1 

NODE X,CALL,PA2 

NODE C,CALL,PA3 

NODE DEL , CALL , INSRT FUNCT DEL 

NODE ACCENT , GOTO , IBMSET 

NODE OTHERS , GOTO , TYPPFK 

* ERASE EOS-ESC-SEQUENCE TABLE * 



IBMESC3 



* 
* 
* 
* 

IBMSET 



IBMSET2 



NODE A, CALL, INDENT 
NODE B, CALL, UNDENT 
NODE C,CALL,COLTAB 
NODE D,CALL,COLBAK 
NODE K,CALL,EINP 
NODE W,CALL,TREQ 
NODE SEQENDER,GOTO, ; 



FUNCT-UP 

FUNCT-DOWN 

FUNCT-RIGHT 

FUNCT-LEFT 

FUNCT-ERASE INPUT 

FUNCT-PRINT 



* SETUP SEQUENCE (FUNCT-ACCENT-SOMETHING) TABLE * 

NODE ESC, GOTO, IBMSET2 
NODE CR,CALL,SETMRG 
NODE OTHERS , GOTO , COMSET 
NODE H,CALL,SETHOM 
NODE L,CALL,CLRTAB 
NODE SEQENDER,GOTO,* 
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* * 

* DATAMEDIA 1520 TABLE * 

EVEN 
DM1520 TERM DM1 5201 
DM1520_CSS1 CSS RS, (BINX) , (BINY) 

CSS GS 



* 
* 
* 

* 

DM1 5201 



* 
* 
* 
* 

DMESC 



CSS VT 

CSS BEL 

CSS BS 

CSS FS 

CSS NONE 

CSS NONE 

CSS DEL 

CSS DEL 

CSS EM 

CSS FF 

CSS FF 

CSS COLON 

CSS LCN,BS,LCZ 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 



POSITION 
ERASE EOL 
LOCAL PRINT 
TONE 

CURSOR LEFT 
CURSOR RIGHT 

— NOT USED — 

— NOT USED — 
SIGNAL INSERT MODE 
SIGNAL END INSERT MODE 
DISCONNECT 

CLEAR 

TERMINAL INITIALIZE 

ILLEGAL ASCII CHAR 

ILLEGAL APL CHAR 

APL CHARS ON 

APL CHARS OFF 

DISPLAY MODE 

— NOT USED — 



* INPUT PARSE TABLE * 



EVEN 

NODE ESC, GOTO, DMESC 
NODE SI, CALL, NL 
NODE FF , CALL , CLEAR 
NODE BS, CALL, LEFT 
NODE FS, CALL, RIGHT 
NODE US, CALL, UP 
NODE LF, CALL, DOWN 
NODE GS , CALL , INSRT 
NODE DEL , CALL , DELETE 
NODE HT, CALL, TAB 
NODE SO , CALL , COLTAB 
NODE CR, CALL, ENTER 
NODE VT,CALL,EEOF 
NODE EM, CALL, HOME 
NODE SYN, CALL, RE SHOW 
NODE SEQENDER,GOTO,* 



TYPE PAIRED ENTRY 

PRINT OFF 

CLEAR 



ERAS EOL 

DEL 

TAB 

PRINT 

RETURN 

ERAS EOS 

HOME 

CTRL-V 



* ESCAPE SEQUENCE TABLE * 



NODE HT,CALL,BTAB 
NODE BS,CALL,BTAB 
NODE FS, CALL, TAB 
NODE US, CALL, INDENT 
NODE LF , CALL , UNDENT 
NODE SO , CALL , COLBAK 
NODE ACCENT , GOTO , DMSET 
NODE OTHERS, GOTO, TYPPFK 



FUNCT TAB 

FUNCT LEFT 

FUNCT RIGHT 

FUNCT UP 

FUNCT DOWN 

FUNCT PRINT ( COLTAB ] 

FUNCT ACCENT 
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* * SETUP TABLE * 

* 

DMSET NODE SO, CALL, SETTAB 
NODE FF,CALL,CLRTAB 
NODE SI,CALL,SETMRG 
NODE EM,CALL,SETHOM 
NODE OTHERS , GOTO , COMSET 
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* DATAMEDIA 1521 TABLE * 

* * 

EVEN 
DM1521 TERM DM1 5201 , DM1 520 



E- 1 4 IBM 7171 Reference Manual and Programming Guide 



* DATAMEDIA 3000 SERIES TERMINAL TABLE * 

EVEN 
DM3045 TERM DM3045I ,FLAGS=X ' 4C00 ' , SGR=DM3SGR 
DM3045_CSS1 CSS ESC, Y, (BINX) , (BINY) REPOSITION 



DM3045I 



CSS ESC,K 

CSS NONE 

CSS BEL 

CSS BS 

CSS ESC,C 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 

CSS ESC, H, ESC, J 

CSS ESC, M, SI 

CSS COLON 

CSS LCN,BS,LCZ 

CSS SO 

CSS SI 

CSS ESC, (BINFLD) 

CSS NONE 



ERASE EOL 
LOCAL PRINT 
TONE 

CURSOR LEFT 
CURSOR RIGHT 

— NOT USED — 

— NOT USED — 
SIGNAL INSERT MODE 
SIGNAL END INSERT MODE 
DISCONNECT 

CLEAR 

TERMINAL INITIALIZE 

ILLEGAL ASCII CHAR 

ILLEGAL APL CHAR 

APL CHARS ON 

APL CHARS OFF 

DISPLAY MODE 

— NOT USED — 



* INPUT PARSE TABLE * 



EVEN 

NODE ESC, GOTO, D3ESC 
NODE CR, CALL, ENTER 
NODE BS, CALL, LEFT 
NODE LF, CALL, DOWN 
NODE DEL , CALL , DELETE 
NODE HT, CALL, TAB 
NODE SYN , CALL , RE SHOW 
NODE SO , CALL , APLON 
NODE SI,CALL,APLOFF 
NODE SEQENDER,GOTO,* 



RETURN 



CTRL-V 
CTRL-N 
CTRL-0 
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* ESCAPE SEQUENCE TABLE * 



D3ESC 



D3ESC2 



* 

* 

D3SET 

D3SET2 



DM3PFKS 



PRINT 

SHIFT LEFT 

HOME 

ERAS EOS 

SHIFT CURSOR UP 

SHIFT CURSOR RIGHT 

SHIFT CURSOR DOWN 

ROLL 

SHIFT ROLL 

MR 

INS CHAR 

TAB 

FUNCT LEFT 

FUNCT DOWN 



NODE ESC, GOTO, D3ESC2 

NODE RBRACK,CALL,NL 

NODE A, CALL, UP 

NODE B, CALL, LEFT 

NODE C, CALL, RIGHT 

NODE H, CALL, HOME 

NODE J,CALL,EEOF 

NODE Q, CALL, UP 

NODE R, CALL, RIGHT 

NODE S, CALL, DOWN 

NODE V,CALL,COLTAB 

NODE W,CALL,COLBAK 

NODE M, CALL, CLEAR 

NODE P,CALL,INSRT 

NODE HT,CALL,BTAB 

NODE BS,CALL,BTAB 

NODE LF , CALL , UNDENT 

NODE INDEX, GOTO, DM3PFKS,PFK1 

NODE NULL, GOTO, FUNCA 

NODE RBRACE , CALL , APLEND 

NODE ACCENT, GOTO, D3 SET FUNCT ACCENT 

NODE TILDE,CALL,PFK26 PFK26 ALTERNATE 

NODE OTHERS, GOTO , TYPPFK (EXCLUDE FUNCT-QWERTY) 

* ESC-ESC SEQUENCE TABLE * 

NODE C, CALL, TAB FUNCT RIGHT 

NODE A, CALL, INDENT FUNCT UP 
NODE V,CALL,COLBAK FUNCT COLTAB 
NODE INDEX, GOTO, DM3 PFKS,PFK 13 
NODE NULL, GOTO, FUNCA 
NODE SEQEND^R,GOTO,* 

* SETUP MODE / 

/ 



* 



NODE ESC, GOTO, D3SET2 
NODE OTHERS, GOTO, COMSET 
NODE RBRACK , CALL , SETMRG 
NODE M , CALL , CLRTAB 
NODE H , CALL , SETHOM 
NODE SEQENDER,GOTO,* 
CSS 'pqrstuvwxyLT' 
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* VT100 TERMINAL TABLE * 

* * 

* 

EVEN 
VT100 TERM VT100I,ORIGIN=1 ,FLAGS=X ' OCOO ' 
VT100_CSS1 CSS ESC, LBRACK, (CHARY) , SEMI, (CHARX) ,H REPOSITION 



VT100I 



* 

* 
* 

VTE 



CSS ESC, LBRACK, K 

CSS NONE 

CSS BEL 

CSS BS 

CSS ESC, LBRACK, C 

CSS NONE 

CSS NONE 

CSS ESC , LBRACK , S 1 , LCQ 

CSS ESC, LBRACK, 30, LCQ 

CSS NONE 

CSS ESC, LBRACK, H, ESC, LBRACK, J 



ERASE EOL 
LOCAL PRINT 
TONE 

CURSOR LEFT 
CURSOR RIGHT 

— NOT USED — 

— NOT USED — 
SIGNAL INSERT MODE 
SIGNAL END INSERT MODE 
DISCONNECT 

CLEAR 



CSS ESC , EQUAL , ESC , LESS , ESC , LBRACK , H , ESC , LBRACK , J , ESC , 
LBRACK , QUESTION , 1 , LCH , ESC , LBRACK , QUESTION , 3 , SEMI , 6 , 
SEMI , 7 , LCL , ESC , LBRACK ,2,0, LCL , ESC , LBRACK , , 
LCQ , ESC , LBRACK , , LCM 

TERMINAL INITIALIZE 
CSS COLON ILLEGAL ASCII CHAR 

CSS NONE ILLEGAL APL CHAR 

CSS NONE APL CHARS ON 

CSS NONE APL CHARS OFF 

CSS ESC, LBRACK, (CHARFLD) ,LCM DISPLAY MODE 
CSS NONE — NOT USED — 

* INPUT PARSE TABLE * 



EVEN 

NODE ESC, GOTO, VTE 
NODE DEL , CALL , DELETE 
NODE HT, CALL, TAB 
NODE CR, CALL, ENTER 
NODE LF,CALL,NL 
NODE BS, CALL, HOME 
NODE SYN , CALL , RESHOW 
NODE SEQENDER,GOTO,* 



"DELETE" 
"TAB" 
"RETURN" 
"LINE FEED" 
"BACK SPACE" 
"CTRL"-V 



* ESCAPE SEQUENCE TABLE * 

NODE ESC, GOTO, VTEE 

NODE 0,GOTO,VTEO 

NODE LBRACK, CALL, PFK2 3 

NODE RBRACK,CALL,PFK24 

NODE LBRACE,CALL,PFK23 

NODE RBRACE,CALL,PFK24 

NODE CR,CALL,PFK36 "RETURN" 

NODE HT,CALL,BTAB "TAB" 

NODE DEL, CALL, EEOF "DELETE" 

NODE ACCENT, GOTO, VTSET 

NODE OTHERS, GOTO, TYPPFK 

NODE SEQENDER,GOTO,* 
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* 

VTEE 

* 

VTEEO 



* 
* 

* 

VTEO 



* 
* 
* 

VTEOP 



* ESC-ESC SEQUENCE TABLE * 

NODE O, GOTO, VTEEO 
NODE SEQENDER,GOTO,* 

* ESC- CURSOR MOVEMENT SEQUENCE * 



LEFT ARROW 
RIGHT ARROW 
UP ARROW 
DOWN ARROW 



NODE D , CALL , COLBAK 

NODE C,CALL,COLTAB 

NODE A, CALL, INDENT 

NODE B , CALL , UNDENT 

NODE INDEX, GOTO, VTPFKS , PFK2 5 

NODE NULL, CALL, ATTN 

NODE SEQENDER,GOTO,* 



* ESC,0 SEQUENCE (KEYPAD AND CURSOR KEYS) * 



"ENTER" 
UP ARROW 
DOWN ARROW 
RIGHT ARROW 
LEFT ARROW 
"PF 4" 



ii _ ii 
ii M 



PERIOD 



NODE M, CALL, CLEAR 

NODE A, CALL, UP 

NODE B, CALL, DOWN 

NODE C, CALL, RIGHT 

NODE D, CALL, LEFT 

NODE S, CALL, PA 1 

NODE LCM,CALL,PA2 

NODE LCL,CALL,PA3 

NODE LCN,CALL,INSRT 

NODE INDEX , GOTO , VTPFKS , PFK 1 

NODE NULL, CALL, ATTN 

NODE LCP, GOTO, VTEOP "0" PREFIX 'SHIFTED' PFK'S 

NODE SEQENDER,GOTO,* 

* ESC,0,P SEQUENCE FOR "SHIFTED" PFK'S (13-24) * 

NODE ESC, GOTO, VTEOPE BEGIN SECOND KEY 

NODE SEQENDER,GOTO,* 
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* 

* 

VTEOPE 

VTEOPEO 



* 

* 

VTSET 



VTSET2 
VTSET3 
VTPFKS 



* ESC,0,P,ESC "SHIFTED" PFK SEQUENCE * 



NODE O, GOTO, VTEOPEO 
NODE SEQENDER,GOTO,* 



MORE OF "SHIFTED" PFK'S 



* ESC,0,P,ESC,0 "SHIFTED" PFK'S COME HERE * 

NODE INDEX, GOTO, VTPFKS, PFK 13 
NODE NULL, CALL, ATTN 
NODE SEQENDER,GOTO,* 

* ESC, ACCENT SETUP REQUEST * 



NODE LF , CALL , SETMRG 
NODE ESC, GOTO, VTSET2 
NODE BS , CALL , SETHOM 
NODE OTHERS , GOTO , COMSET 
NODE 0,GOTO,VTSET3 
NODE SEQENDER,GOTO,* 
NODE M,CALL,CLRTAB 
NODE SEQENDER,GOTO,* 
CSS ' PQRwxytuvqrs ' 



"LINE FEED" 
"BACK SPACE" 

"ENTER" 
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* ADM3A TERMINAL TABLE * 

EVEN 

ADM3A TERM ADM3AI 

ADM3A_CCS1 CSS ESC, EQUAL, (BINY) , (BINX) REPOSITION 

CSS NONE ERASE EOL 

CSS NONE LOCAL PRINT 

CSS BEL TONE 

CSS BS CURSOR LEFT 

CSS NONE CURSOR RIGHT 

CSS NONE — NOT USED — 

CSS NONE — NOT USED — 

CSS NONE SIGNAL INSERT MODE 

CSS NONE SIGNAL END INSERT MODE 

CSS NONE DISCONNECT 

CSS SUB CLEAR 

CSS SUB TERMINAL INITIALIZE 

CSS COLON ILLEGAL ASCII CHAR 

CSS NONE ILLEGAL APL CHAR 

CSS NONE APL CHARS ON 

CSS NONE APL CHARS OFF 

CSS NONE DISPLAY MODE 

CSS NONE — NOT USED — 



* 

* 
* 

ADM3AI 



* INPUT PARSE TABLE * 



EVEN 

NODE ESC, GOTO, A3AESC 
NODE BS, CALL, LEFT 
NODE FF, CALL, RIGHT 
NODE VT, CALL, UP 
NODE LF, CALL, DOWN 
NODE EM,CALL,INSRT 
NODE DEL, CALL, DELETE 
NODE HT, CALL, TAB 
NODE SI,CALL,BTAB 
NODE NAK,CALL,NL 
NODE CR, CALL, ENTER 
NODE SUB , CALL , CLEAR 
NODE DLE,CALL,EEOF 
NODE RS, CALL, HOME 
NODE SYN,CALL,RESHOW 
NODE SEQENDER,GOTO,* 



ESCAPE SEQUENCE START 
H CURSOR LEFT 
L CURSOR RIGHT 
K CURSOR UP 
J CURSOR DOWN 

Y TOGGLE INSERT MODE 
DELETE 

I TAB 

O BACKTAB 

U NEWLINE 

ENTER 
Z CLEAR 
P ERASE EOF 

HOME 

V REDISPLAY SCREEN 



* ADM3A ESC SEQUENCE * 



A3AESC 



NODE HT , CALL , COLTAB 
NODE SI,CALL,COLBAK 
NODE FF , CALL , INDENT 
NODE BS , CALL , UNDENT 
NODE ACCENT, GOTO, A3ASET 
NODE OTHERS, GOTO, TYPPFK 

* ADM3A SETUP SEQUENCE * 
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* 

A3ASET NODE RS , CALL , SETHOM 
NODE NAK,CALL,SETMRG 
NODE SUB, CALL, CLRTAB 
NODE OTHERS , GOTO , COMSET 
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* ADM31 TERMINAL TABLE * 

* (ALSO RELATED TO TELEVIDEO, ZENTEC, AND OTHER TERMINALS) * 



EVEN 
ADM3 1 TERM ADM3 1 I , FLAGS=X ' 0000 ' , SGR=ADM3 1 ATR 
ADM31_CSS1 CSS ESC, EQUAL, (BINY) , (BINX) REPOSITION 

CSS ESC,T ERASE EOL 

CSS NONE LOCAL PRINT 

CSS BEL TONE 

CSS BS CURSOR LEFT 

CSS NONE CURSOR RIGHT 

CSS NONE — NOT USED - 

CSS NONE — NOT USED — 

CSS NONE SIGNAL INSERT MODE 

CSS NONE SIGNAL END INSERT MODE 

CSS NONE DISCONNECT 

CSS RS,ESC,Y CLEAR 
CSS ESC, C, ESC, D,F, ESC, QUOTE, ESC, LCG,RS, ESC, Y 

* TERMINAL INITIALIZE 

CSS COLON ILLEGAL ASCII CHAR 

CSS NONE ILLEGAL APL CHAR 

CSS NONE APL CHARS ON 

CSS NONE APL CHARS OFF 

CSS ESC,G, (BINFLD) DISPLAY MODE 

CSS NONE — NOT USED — 



ADM3 1 I 
ADMNORM 



* INPUT PARSE TABLE * 



EVEN 

NODE SOH,GOTO,FUNBPFK 
NODE ESC, GOTO, A3 1 ESC 
NODE US, CALL, NL 
NODE BS, CALL, LEFT 
NODE FF, CALL, RIGHT 
NODE VT, CALL, UP 
NODE LF, CALL, DOWN 
NODE DEL, CALL, DELETE 
NODE HT , CALL , COLTAB 
NODE CR, CALL, ENTER 
NODE RS, CALL, HOME 
NODE SYN,CALL,RESHOW 
NODE SEQENDER,GOTO,* 



"FUNCT" KEY INITIAL CHAR 
ESCAPE SEQUENCE 
"NEW LINE" KEY 



"HOME" KEY 
CTRL-V 



* ESCAPE SEQUENCE TABLE * 



A3 1 ESC NODE ESC, GOTO, A31EESC 
NODE Q, CALL, NULL 
NODE W, CALL, CLEAR 
NODE E,CALL,INSRT 
NODE R,CALL,EEOF 
NODE T, CALL, TAB 
NODE Y , CALL , INDENT 
NODE a5,CALL,CURSEL 
NODE I , CALL , COLBAK 
NODE ACCENT,G0T0,A31SET 
NODE SEQENDER,GOTO,* 



"CHAR INSERT" 
"CHAR DELETE" 
"LINE INSERT" 
"LINE DELETE" 
"LINE ERASE" 
"PAGE ERASE" 
"SEND PAGE" 
"BACKTAB" 
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A3 1 SET 



A31ESET 

* 
* 

A31EESC 



* ADM31 SETUP SEQUENCE * 



NODE RS,CALL,SETHOM 
NODE US,CALL,SETMRG 
NODE ESC,G0T0,A31ESET 
NODE OTHERS , GOTO , COMSET 
NODE W,CALL,CLRTAB 
NODE SEQENDER,GOTO,* 

* ESCAPE FOLLOWED BY A FUNCTION 

* SHIFTS IT 

NODE Q,CALL,DPFM,DUP 
NODE W,CALL,DPFM,FM 
NODE E,CALL,LPRT 
NODE R,CALL,EINP 
NODE T,CALL,BTAB 
NODE Y, CALL, UNDENT 
NODE 35,CALL,TREQ 
NODE a7,CALL,TREQ 
NODE SEQENDER,GOTO,* 



KEY LOGICALLY * 



"CHAR INSERT" 
"CHAR DELETE" 
"LINE INSERT" 
"LINE DELETE" 
"LINE ERASE" 
"PAGE ERASE" 
"SEND PAGE" 
"SEND" 



DUP 
FM 
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* TELEVIDEO 912 TERMINAL * 

* * 

* 

EVEN 
TVI912 TERM TVIDI,ADM31 

EVEN 
TVIDI NODE SOH,GOTO,TVDSOH ESCAPE INTRODUCER 

NODE ESC, CALL , INSRT 

NODE SUB, CALL, CLEAR 

NODE RS,CALL,NL "HOME" (NO GOOD NEWLINE) 

NODE OTHERS, GOTO, ADMNORM REST LIKE ADM3 1 



* 

TVDSOH 



* 
* 

* 

TVSET1 

TVSET2 



* FUNCT SEQUENCE TABLE * 

NODE HT,GOTO,FUNCX,INCOLBAK 
NODE DEL, GOTO, FUNCX,INEEOF ERASE EOF 
NODE BS , GOTO , FUNCX , INBTAB LEFT 
NODE FF, GOTO, FUNCX, INTAB RIGHT 

NODE VT, GOTO, FUNCX, ININDENT UP 
NODE LF , GOTO , FUNCX , INUNDENT DOWN 
NODE ACCENT, GOTO, TVSET1 
NODE RS, GOTO, FUNCX, INHOME 
NODE OTHERS , GOTO , FUNCPFK 

* FUNCTION SEQUENCE TERMINATOR FOR SETUP INTRODUCER * 

NODE CR,GOTO,TVSET2 
NODE SEQENDER,GOTO,* 
NODE ESC, CALL, SETHOM 
NODE SUB , CALL , CLRTAB 
NODE RS,CALL,SETMRG 
NODE OTHERS , GOTO , COMSET 
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* TELEVIDEO 920 TERMINAL * 

* * 

* 

EVEN 
TVI920 TERM TVIDI,ADM31 
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* TELEVIDEO 950 TABLE * 

* * 

* 

* SHARED OUTPUT CONTROL STRINGS, REFERENCED BELOW 
* 

TVICS1 CSS ESC, EQUAL, (BINY) , (BINX) POSITION 
TVICS2 CSS ESC,T ERASE EOL 

TVICS3 CSS NONE LOCAL PRINT 

TVICS4 CSS BEL TONE 

TVICS5 CSS BS CURSOR LEFT 

TVICS6 CSS FF CURSOR RIGHT 

TVICS7 CSS NONE -- NOT USED — 

TVICS8 CSS NONE — NOT USED — 

TVICS9 CSS ESC ,LCF, 'INSERT MODE',CR SIGNAL INSERT MODE 
TVICS10 CSS ESC,LCF,CR SIGNAL END INSERT MODE 

TVICS11 CSS NONE DISCONNECT 

TVICS12 CSS ESC, ASTERISK, (DELAY) CLEAR 
TVICS13 CSS SI, ESC, O, ESC, D,F, ESC, PERCENT, ESC, DQUOTE, 
DC4 , ESC , LCF , ESC , G , SPACE , SPACE , CR , ESC , LCG , 
(DELAY) , ESC, 0,1 , 7 ,ESC, , 2 ,6 ,RS , SUB,ESC,LCN, 
ESC,X,ESC,LCL,ESC,LCR, (DELAY) 

* TERMINAL INITIALIZE 



TVICS14 


CSS 


COLON 


ILLEGAL ASCII CHAR 


TVICS15 


CSS 


NONE 


ILLEGAL APL CHAR 


TVICS16 


CSS 


NONE 


APL CHARS ON 


TVICS17 


CSS 


NONE 


APL CHARS OFF 


TVICS18A 


CSS 


ESC,G, (BINFLD) 


DISPLAY MODE (ATR - ' 


TVICS18B 


CSS 


ESC, (BINFLD) 


DISPLAY MODE (MOD - ' 


TVICS19 


CSS 


NONE 


~ NOT USED — 




EVEN 




TVI950 


TERM TVII,FLAGS=X'0C00 1 


, DELAY= 100, SGR=ADM3 1 MOD 


TVI950_CSS1 


CSS 


EQU=TVICS1 






CSS 


EQU=TVICS2 






CSS 


EQU=TVICS3 






CSS 


EQU=TVICS4 






CSS 


EQU=TVICS5 






CSS 


EQU=TVICS6 






CSS 


EQU=TVICS7 






CSS 


EQU=TVICS8 






CSS 


EQU=TVICS9 






CSS 


EQU=TVICS10 






CSS 


EQU=TVICS11 






CSS 


EQU=TVICS12 






CSS 


EQU=TVICS13 






CSS 


EQU=TVICS14 






CSS 


EQU=TVICS15 






CSS 


EQU=TVICS16 






CSS 


EQU=TVICS17 






CSS 


EQU=TVICS18B 






CSS 


EQU=TVICS19 






EVEN 
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* 
TVI950R 


TERM 


TVI I , FLAGS=X ' 8 ' , DELAY= 100, SGR=ADM3 1 ATR 




CSS 


EQU=TVICS1 




CSS 


EQU=TVICS2 




CSS 


EQU=TVICS3 




CSS 


EQU=TVICS4 




CSS 


EQU=TVICS5 




CSS 


EQU=TVICS6 




CSS 


EQU=TVICS7 




CSS 


EQU=TVICS8 




CSS 


EQU=TVICS9 




CSS 


EQU=TVICS10 




CSS 


EQU=TVICS11 




CSS 


EQU=TVICS12 




CSS 


EQU=TVICS13 




CSS 


EQU=TVICS14 




CSS 


EQU=TVICS15 




CSS 


EQU=TVICS16 




CSS 


EQU=TVICS17 




CSS 


EQU=TVICS18A 




CSS 


EQU=TVICS19 



* * INPUT PARSE TABLE * 

* 

EVEN 
TVI I NODE SOH, GOTO, TVI SOH "FUNCT" KEY INTRODUCER 

NODE ESC, GOTO, TVIESC ESCAPE SEQUENCE 

NODE SUB, CALL, CLEAR "CLEAR" 

NODE RS, CALL, HOME "HOME" 

NODE LF,CALL,NL "LINEFEED" 

NODE SYN, CALL, DOWN 

NODE OTHERS, GOTO, ADMNORM REST LIKE ADM31 

NODE SEQENDER,GOTO,* 
* 

* * FUNCT SEQUENCE STATE (PFKS) * 

* 

TVISOH NODE INDEX, GOTO, TVIPFK1 ,PFK1 

NODE NULL, GOTO, FUNCA 

NODE INDEX, GOTO, TVI PFK2 , PFK 13 

NODE NULL, GOTO, FUNCA 

NODE COMMA, GOTO, FUNCA, PA 1 

NODE LESS, GOTO, FUNCA, PA 1 

NODE PERIOD, GOTO, FUNCA, PA2 

NODE GREATER, GOTO, FUNCA, PA2 

NODE SLASH , GOTO , FUNCA , PA3 

NODE QUESTION, GOTO, FUNCA, PA3 

NODE SEQENDER,GOTO,* 
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* ESCAPE SEQUENCE TABLE * 



TVIESC 



NODE ESC,G0T0,A31EESC 



* 
* 

TVISET 



TVIPFK1 
TVIPFK2 



"LINE DELETE" 
"CHAR INSERT" 
"CHAR INSERT" 
"CHAR DELETE" 
"LINE INSERT" 
"LINE DELETE" 
"LINE ERASE" 
"LINE ERASE" 
"PAGE ERASE" 
"PAGE ERASE" 
"SEND PAGE" 
"SEND PAGE" 
"BACKTAB" 



(SHIFT) 
(SHIFT) 

(SHIFT) 
(SHIFT) 
(SHIFT) 



NODE O, GOTO, TVISET 

NODE Q,CALL,PFK12 

NODE LCQ,CALL,PFK24 

NODE W, CALL, NULL 

NODE E,CALL,INSRT 

NODE R,CALL,EEOF 

NODE T, CALL, TAB 

NODE LCT , CALL , BTAB 

NODE Y, CALL, INDENT 

NODE LCY, CALL, UNDENT 

NODE a)7,CALL,CURSEL 

NODE a6,CALL,TREQ 

NODE I , CALL , COLBAK 

NODE ASTERISK, CALL, RESHOW 

NODE SEQENDER,GOTO,* 



* FUNCTION SEQUENCE TERMINATOR FOR SETUP INTRODUCER * 



NODE RS,CALL,SETHOM 
NODE LF,CALL,SETMRG 
NODE SUB , CALL , CLRTAB 
NODE OTHERS , GOTO , COMSET 
CSS ' aABCDEFGHI J ' 
CSS ACCENT , ' abcdef ghi j ' 
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* TYPEWRITER TERMINAL TABLE * 

* AN ATTEMPT TO MAKE THE AVERAGE ASCII TYPEWRITER TERMINAL * 

* DEVICE USEFUL * 

* * 

* 

EVEN 
TYPETERM TERM TPTMI ,FLAGS=X ' 8000 ' 
TYPETERM CSS1 CSS (HARDCOPY) 



* 
* 
* 
* 
* 

TPTMI 



* 

* 
* 
* 

TPTMESC 



CSS NONE 

CSS NONE 

CSS BEL 

CSS BS 

CSS BLANK 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 

CSS CR,LF,LF,LF 

CSS CR,FF 

CSS COLON 

CSS LCN,BS,LCZ 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 



POSITION "CURSOR" 
ERASE EOL 
LOCAL PRINT 
TONE 

CURSOR LEFT 
CURSOR RIGHT 

— NOT USED — 

— NOT USED — 
SIGNAL INSERT MODE 
SIGNAL END INSERT MODE 
DISCONNECT 

CLEAR 

"TERMINAL" INITIALIZE 

ILLEGAL ASCII CHAR 

ILLEGAL APL CHAR 

APL CHARS ON 

APL CHARS OFF 

DISPLAY MODE 

— NOT USED — 



* INPUT PARSE TABLE * 



EVEN 

NODE ESC, GOTO, TPTMESC 
NODE LF,CALL,NL 
NODE BS, CALL, LEFT 
NODE DEL, CALL, DELETE 
NODE HT , CALL , COLTAB 
NODE CR, CALL, ENTER 
NODE SYN,CALL,RESHOW 
NODE SEQENDER,GOTO,* 



ESCAPE SEQUENCE 
"NEW LINE" KEY 



COLUMN TAB 
CTRL-V 



* ESCAPE SEQUENCE TABLE * 



NODE I,CALL,INSRT 
NODE LCI , CALL , INSRT 
NODE B,CALL,BTAB 
NODE LCB , CALL , BTAB 
NODE T, CALL, TAB 
NODE LCT, CALL, TAB 
NODE HT , CALL , COLBAK 
NODE OTHERS , GOTO , TYPPFK 



INSERT TOGGLE KEY 

INSERT TOGGLE KEY 

BACKTAB 

BACKTAB 

TAB 

TAB 

COLUMN BACKTAB 
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* HARDCOPY DEVICE TABLE * 

* REQUIRED WHEN USING RSCS LINE DRIVER ' DMTRPT ' * 

* TO EMULATE 3286 PRINTER DEVICES * 

* 

EVEN 
HARDCOPY TERM HCPYI ,FLAGS=X ' 8004 ' 
HARDCOPY CCS1 CSS NONE 



* 
* 

HCPYI 



CSS NONE 

CSS NONE 

CSS BEL 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 

CSS CR,FF 

CSS COLON 

CSS LCN,BS,LCZ 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 



POSITION "CURSOR" 
ERASE EOL 
LOCAL PRINT 
TONE 

CURSOR LEFT 
CURSOR RIGHT 

— NOT USED — 

— NOT USED — 
SIGNAL INSERT MODE 
SIGNAL END INSERT MODE 
DISCONNECT 

CLEAR 

"TERMINAL" INITIALIZE 

ILLEGAL ASCII CHAR 

ILLEGAL APL CHAR 

APL CHARS ON 

APL CHARS OFF 

DISPLAY MODE 

— NOT USED — 



* INPUT PARSE TABLE * 



EVEN 

NODE ESC,GOTO,TYPPAK 
NODE CR, CALL, ENTER 
NODE SEQENDER,GOTO,* 



PA KEYS 
ENTER 
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* PLOTTER - HARDCOPY OUTPUT DEVICE IN TRANSPARENT MODE * 

EVEN 
PLOTTER TERM HCPYI ,FLAGS=X ' 8000 ' 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
CSS NONE 
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* ROLM 3270 DEVICE TABLE - CEDAR, CYPRESS, JUNIPER * 

EVEN 
ROLM3270 TERM ROLM3270_I ,ORIGIN=X' 20 ' ,FLAGS=X' 0C00 ' , 

SGR=ROLM3 2 7 0_SGR , RCHRS=ROLM3 2 7 0_RCHRS , DELAY=0 

CSS ESC,Y, (BINY) , (BINX) POSITION "CURSOR" 



CSS ESC,K 

CSS NONE 

CSS BEL 

CSS ESC,D 

CSS ESC,C 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 

CSS NONE 

CSS ESC, H, ESC, J 

CSS ESC, H, ESC, J 

CSS ESC,F,LCA,ESC,G 

CSS NONE 

CSS NONE 

CSS NONE 

CSS ESC, (BINFLD) 

CSS NONE 



ERASE EOL 
LOCAL PRINT 
TONE 

CURSOR LEFT 
CURSOR RIGHT 

— NOT USED — 

— NOT USED — 
SIGNAL INSERT MODE 
SIGNAL END INSERT MODE 
DISCONNECT 

CLEAR 

"TERMINAL" INITIALIZE 

ILLEGAL ASCII CHAR 

ILLEGAL APL CHAR 

APL CHARS ON 

APL CHARS OFF 

DISPLAY MODE 

— NOT USED — 



* 

* * SPECIAL TABLES * 

* 

ROLM3270_RCHRS CSS NONE,WRU, SYN,DC2 , CAN, XON,XOFF, ETB 
* 

ROLM3270_SGR DC X ' 36353635363636363636 * 
* 

ROLMPFK1 CSS '1234567890' 

ROLMPFK2 CSS 'QWERTYUIOPASDFGHJKLZXCVNM 1 , COMMA 
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* * INPUT PARSE TABLE * 

EVEN 
ROLM3270_I NODE ESC, GOTO, NODE01 
NODE SOH,CALL,CURSEL 
NODE STX , CALL , BTAB 
NODE ETX,CALL,EEOF 
NODE EOT, CALL, DELETE 
NODE ACK,CALL,INSRT 
NODE BEL, CALL, NL 
NODE BS, CALL, LEFT 
NODE HT, CALL, TAB 
NODE LF, CALL, DOWN 
NODE VT, CALL, UP 
NODE FF, CALL, RIGHT 
NODE CR, CALL, ENTER 
NODE SO, CALL, HOME 
NODE DC4,CALL,PA1 
NODE NAK,CALL,PA3 
NODE EM,CALL,PA2 
NODE SUB, CALL, CLEAR 
NODE RS,CALL,TREQ 
NODE SEQENDER,GOTO,* 
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* 

* 
* 

NODEO 1 



* 
* 
* 

NODE 02 



* ESCAPE SEQUENCE TABLE * 

NODE V,CALL,RESHOW 
NODE LCV,CALL,RESHOW 
NODE HT,CALL,COLTAB 
NODE STX,CALL,COLBAK 
NODE ESC, GOTO, NODE02 
NODE D , CALL , DPFM , DUP 
NODE LCD, CALL, DPFM, DUP 
NODE X,CALL,EINP 
NODE LCX,CALL,EINP 
NODE F, CALL, DPFM, FM 
NODE LCF, CALL, DPFM, FM 
NODE ACCENT, GOTO, NODEO 3 
NODE SEQENDER,GOTO,* 

* ESC - ESC SEQUENCE TABLE * 

NODE INDEX, GOTO, ROLMPFK 1 ,PFK1 
NODE NULL, CALL, ATTN 

NODE INDEX , GOTO , ROLMPFK2 , PFK1 1 
NODE NULL, CALL, ATTN 

NODE CR,CALL,TREQ 
NODE COLON, CALL, UNDENT 
NODE SEMI, CALL, INDENT 
NODE B, CALL, DISC 
NODE SEQENDER,GOTO,* 
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* * ESC - ACCENT SETUP REQUESTS TABLE * 

* 

NODE03 NODE HT , CALL , SETTAB 

NODE NAK,CALL,SETMRG 

NODE SUB, CALL, CLRTAB 

NODE SO,CALL,SETHOM 

NODE COMMA, CALL, INI T 

NODE PERIOD, CALL, DISC 

NODE A,CALL,APLEND 

NODE C , CALL , RESET , PARM=X '03' 

NODE D , CALL , RESET , PARM=X '08' 

NODE E, CALL, RESET ,PARM=X' 02' 

NODE I,CALL,RESET,PARM=X , 09' 

NODE N , CALL , RESET , PARM=X '01' 

NODE P,CALL,PCOFF 

NODE Q,CALL,ALTK 

NODE V, CALL, RESET, PARM=X' 04* 

NODE Z, CALL, RESET 

NODE LCA,CALL,APLON 

NODE LCC , CALL , SET , PARM=X '03' 

NODE LCD , CALL , SET , PARM=X '08' 

NODE LCE,CALL,SET,PARM=X I 02' 

NODE LCI,CALL,SET,PARM=X , 09 I 

NODE LCM,CALL,APLOFF 

NODE LCN , CALL , SET , PARM=X '01' 

NODE LCP , CALL , PCON 

NODE LCQ , CALL , ALTK , PARM=X '01' 

NODE LCV , CALL , S ET , P ARM=X '04' 

NODE LCZ, CALL, SET 

NODE EOT, CALL, DELTAB 

NODE SEQENDER,GOTO,* 



) 
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* * 

* IBM 316X - SUPPORTS 3161 AND 3163 * 



IBM316X 



EVEN 

TERM IBM3 1 6X_I , ORIGIN=X * 20 * , FLAGS=X ' 0C00 ' , 
SGR=IBM3 1 6X_SGR , RCHRS=IBM3 1 6X_RCHRS , DELAY=0 

CSS ESC,Y, (BINY) , (BINX) POSITION CURSOR 
CSS ESC, I ERASE EOL 

CSS ESC, SPACE, W LOCAL PRINT 

CSS BEL TONE 

CSS ESC,D CURSOR LEFT 

CSS ESC,C CURSOR RIGHT 

CSS NONE — NOT USED — 

CSS NONE — NOT USED — 

CSS NONE SIGNAL INSERT MODE 

CSS NONE SIGNAL END INSERT MODE 

CSS D,I,S,C,0,N,N,E,C,T,E,D, PERIOD , PERIOD 

DISCONNECT 



CSS ESC, H, ESC, J 

CSS ESC, H, ESC, J 

CSS COLON, BEL 

CSS NONE 

CSS NONE 

CSS NONE 

CSS ESC, 34, (BINFLD) 

CSS NONE 



CLEAR 

"TERMINAL" INITIALIZE 
ILLEGAL ASCII CHAR 
ILLEGAL APL CHAR 
APL CHARS ON 
APL CHARS OFF 
DISPLAY MODE 
— NOT USED — 



* * SPECIAL TABLES * 

IBM3 1 6X_RCHRS CSS NONE, BEL, DC2 ,DC4 , CAN, XON,XOFF,ETB 
* 

IBM316X_SGR DC X ' 50404840484040404040 ' 
* 

CSS 'abcdefghijkl 1 

CSS *mno' 

CSS ' QWERTYUIOP [ ] ' 

CSS N,X"01 ' ,E,X'02' ,C,X'03' ,V,X'04' ,D,X'08' ,I,X'09' 

CSS LCN,X'01 ' ,LCE,X'02' ,LCC,X'03' ,LCV,X'04' ,LCD,X'08' ,LCI,X'0' 



ABCDEF 

MNO 

QWERT 

NECVDI 

LNECVDI 

IBM316X I 



* INPUT PARSE TABLES * 

EVEN 

NODE ESC, GOTO,N3 16X1 
NODE BS,CALL,RUBOUT 
NODE HT, CALL, TAB 
NODE LF,CALL,NL 
NODE VT,CALL,DPFM,DUP 
NODE FF,CALL,DPFM,FM 
NODE CR, CALL, ENTER 
NODE SYN,CALL,RESHOW 
NODE DEL, CALL, DELETE 
NODE SEQENDER,GOTO,* 
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* * ESCAPE SEQUENCE TABLE * 

* 

N316X1 NODE 3 2 , CALL , BTAB 
NODE A, CALL, UP 
NODE B, CALL, DOWN 
NODE C, CALL, RIGHT 
NODE D, CALL, LEFT 
NODE H, CALL, HOME 
NODE I,CALL,EEOF 
NODE K,CALL,EINP 
NODE L, GOTO, N3 16X5 
NODE P, GOTO, N3 16X6 
NODE Q , CALL , DELETE 
NODE 38, GOTO, N3 16X4 

NODE EXCLAIM, GOTO, N3 16X2 * PFKEYS 13-24 
NODE ESC, GOTO, N3 16X9 * PFKEYS 25-36 

NODE DQUOTE, GOTO, N3 16X3 * => SETUPS 

NODE INDEX, GOTO, ABCDEF,PFK1 
NODE NULL, GOTO, FUNCA 
* 

NODE SEQENDER,GOTO,* 

* * PA KEYS AND PF KEYS 13-24 * 

N316X2 NODE INDEX, GOTO, MNO, PA 1 

NODE NULL, GOTO, FUNCA 
* 

NODE INDEX, GOTO, ABCDEF,PFK 13 
NODE NULL, GOTO, FUNCA 

NODE A, GOTO, N3 16X7 
NODE SEQENDER,GOTO,* 

* 

N316X3 NODE A,GOTO,NODE34 

NODE SEQENDER,GOTO,* 

N316X4 NODE CR , CALL , ENTER 

NODE SEQENDER,GOTO,* 
* 

N316X5 NODE CR , CALL , CLEAR 

NODE SEQENDER,GOTO,* 
* 

N316X6 NODE SPACE, GOTO, NODE3 5 

NODE SEQENDER,GOTO,* 
* 

N316X7 NODE ESC, GOTO, N31 6X8 
NODE SEQENDER,GOTO,* 
* 

N316X8 NODE 0,CALL,TREQ 

NODE SEQENDER,GOTO,* 
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* 
N316X9 



* 

* 

NODE34 



* 

* 

NODE35 

* 
NODE 3 6 



* 

* 

NODE 3 7 



* PF KEYS 25-36 * 

NODE INDEX, GOTO, ABCDEF,PFK2 5 
NODE NULL, GOTO, FUNCA 
NODE SEQENDER,GOTO,* 

* SETUP SEQUENCES * 

NODE HT,CALL,SETTAB 
NODE CR,CALL,SETMRG 
NODE ESC, GOTO, NODE36 
NODE COMMA, CALL, INI T 
NODE PERIOD, CALL, DISC 

NODE MATCH, GOTO, NECVDI 
NODE NULL, CALL, RESET 

NODE MATCH, GOTO, LNECVD I 
NODE NULL, CALL, SET 

NODE LCP,CALL,PCON 

NODE P,CALL,PCOFF 

NODE LCZ, CALL, SET 

NODE Z, CALL, RESET 

NODE DEL, CALL, DELTAB 

NODE Q,CALL,ALTK 

NODE LCQ , CALL , ALTK , PARM=X ' 1 ' 

NODE SEQENDER,GOTO,* 



NODE BS,CALL,INSRT 
NODE SEQENDER,GOTO,* 

* MULTIPLE CHARACTER SETUP SEQUENCES * 

NODE A, CALL, INDENT 
NODE B, CALL, UNDENT 
NODE C,CALL,COLTAB 
NODE D,CALL,COLBAK 
NODE H,CALL,SETHOM 
NODE K, CALL, CURS EL 
NODE L, GOTO, NODE 3 7 
NODE Q, CALL, DELTAB 
NODE SEQENDER,GOTO,* 



NODE CR,CALL,CLRTAB 
NODE SEQENDER,GOTO,* 
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* VTAM DISCONNECT STRING * 

VTAMDISC DC X'OAOO 1 LENGTH FIELD 

DC X'016C6102D3D6C7D6C6C6' TEST REQ - LOGOFF 
* 



Appendix E. ROM Data Base Organization E-39 



E-40 IBM 7171 Reference Manual and Programming Guide 



Index 



Special Characters 



.PRO 

File Format C-8 
.TML 

File Format C-8 
.CTL C-5 

Examples C-6 

Syntax Summary C-7 
.CTL files C-5 
.IMG C-5 

Example C-7, C-8 

File Format C-7 

ORG= C-8 
.IMG files C-5 
PRO C-5 
.PRO files C-5 
.TML C-5 
.TML files C-5 
.TRM C-5 
.TRM files C-5 



Asynchronous Status and Sense Conditions 6-33 

asynchronous status change notification 6-43 

Attention 6-29 

attention functions 2-4 

Attention ID (AID) Configurations 6-12 

Attributes 6-20 

Autoanswer 5-6 

autobaud 1-1,5-6 

autobaud recognition 2-3 

automatic indentation 3-4 



B 



basic color 1-2 
baud rate 1-1 
binfld 4-16 
BINKEY C-9 
BREAK key 3-11 
Bus Out Check 6-19 
Busy 6-29 







S 



) 



ADM3A 

See Lear Siegler ADM-3A 
ADM31 

See Lear Siegler ADM-31 
alphanumeric in numeric-only fields 3-7 
alternate 

display of attributes 3-9 

keyboard arrangement 3-10 
alternate screen size support 3-1 
APL character set 3-8 

APL mode off 3-8 

APL mode on 3-8 

ASCII input in APL mode 3-9 
application data 6-3 
ASCII 6-3 

character name table 4-39 

display terminal 

requirements 2-11 

restrictions 2-9 

with graphic capability 2-5 

hardcopy devices 

auxiliary printer 2-9 
3286 emulation 2-9 

number of devices supported 2-2 

output-only devices 2-9 

printers, restrictions 2-10 
ASCII character name table B-4 
Asynchronous Communications Adapter 1-2 
asynchronous operation 2-5 



card container slot position identification 8-15 

carriage return 2-1,2-14 

CC board 2-3 

CCITT V.24 5-2 

CCITT V.28 5-2 

CCW 6-2 

cent symbol (c) 3-1 

Chaining 6-26 

Channel End 6-29 

Channel selection 6-26 

character error reset 3-10,3-11 

charfld 4-16 

color terminals 1-2, 3-3 

column tabs 3-4 

Command Initiation 6-26 

Command Reject 6-19 

commands 6-3 

compatibility 

ASCII display terminals 2-9 

ASCII printers 2-10 
control functions 

pacing start 3-11 

pacing stop 3-11 
Control Unit END 6-29 
Control Unit to Host interactions 6-25 
controlling entry to non-numeric fields 3-7 
CPU board 2-3 
CR 6-25 
CSS Strings 4-11 
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customization 

changing communication lines 2-11 
general description 2-11 



D 



6-36 



B-43 



Data Check 6-19 

Data Pending State 

Data Stream 6-3 

Datamedia DM- 1520 and DM- 1521 

control and cursor movement keys 

installation hints B-47 

local reset and control functions B-47 

program function keys B-45 

setup functions B-46 
Datamedia DM-3045 

control and cursor movement keys B-48 

installation hints B-52 

local reset and control functions B-52 

program function keys B-50 

setup functions B-51 
debugging facilities 8-13 
default tables 1-2 
Default TDTs C-2 
delay - terminal 4-30 
device definition tables 1-2 
Device End 6-29 

differences in character representation 3-1 
Digital Equipment VT-100 

control and cursor movement keys B-37 

installation hints B-42 

local reset and control functions B-42 

program function keys B-40 

setup functions B-41 
Display Fields 6-20 
DM1520 

See Datamedia DM-1520 and DM-1521 
DM1521 

See Datamedia DM-1520 and DM-1521 
DM3045 

See Datamedia DM-3045 
DOS BAT Files C-100 
DOS Batch Files C-100 

Using 7171IO C-101 
Example C-102 

Using 7171LINK C-100 

Using 7171MLNK C-100 

Using 7171MPRT C-101 



E 



6-17 



EAU Command 

EBCDIC 6-3 

EIA RS-232-C 

EM 6-25 

Ending Status and Sense Conditions 



5-1 



ENTER key 6-2 

ENTER TERMINAL TYPE message 3-10 

Erase Unprotected to Address (EUA) Order 6-10 

Erase/Write Alternate command 6-7 

Erase/Write Command 6-6 

error detection and recovery 8-13 

Error Recovery 

intermittent errors 8-21 
no power light 8-12 
no ready light 8-13 
Error Recovery Procedures 6-34 
error situations 

communication lines 3-11 
bad parity 3-11 
BREAK key 3-11 
Character Error Reset 3-11 
framing error 3-11 
full type-ahead buffer 3-13 
keyboard lock 3-13 

RESET key 3-13 
master reset 3-13 
output data stream 3-12 
screen refresh 3-12 
protected data 3-12 
recovery 2-5 

specifying terminal type 8-4 
wrong key 3-12 
extended functions 1-1 







FF 6-25 

Field Attribute Character 6-21 

Field Attribute Character Bit Assignment 

File extensions C-5 

full duplex character mode 2-2 



6-22 



G 



Graphic Escape (GE) Order 6-8 



H 



2-2 



6-32 



hardcopy 4-14 
hardware 

configuration for IBM 7171 

support 

See operating environment 
HEXKEY C-9 
highlighted fields 3-2 
highlighting 4-16 

host application program setup functions 
host disconnect methods 4-65 



6-40 
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host initiated line drop 6-43 
host operating system 2-11 
host processor 2-3 
host processors 1-1 
Host Translate table 4-29 
Host Translate Tables 

example of modification 
host translation tables A-l 

how to read A-l 

3277 tables A-l 

3278 tables A-l 



4-59, 4-62 







IBM Personal Computer running in 3101 Emulation Mode 
control and cursor movement keys B-10 
installation hints B-13 
local reset and control functions B-13 
program function keys B-l 1 
setup functions B-l 2 
starting the 3 1 1 Emulation Program B-13 
IBM 3101 

control and cursor movement keys B-5 
installation hints B-9 
local reset and control functions B-9 
program function keys B-7 
setup functions B-8 
IBM316X 

control and cursor movement keys B-53 
installation hints B-5 6 
local reset and control functions B-5 6 
program function keys B-54 
setup functions B-5 5 
IBM 3270 

emulated and extended functions 3-1 

alternate display of attributes 3-9 

alternate keyboard arrangement 3-10 

APL character set 3-8 

asynchronous status change notification 6-43 

automatic indentation 3-4 

clear mark 6-42 

column tabs 3-4, 6-42 

controlling entry to non-numeric fields 3-7 

host initiated line drop 6-43 

keyboard initiated line drop 3-9 

null processing 3-5 

primary keyboard arrangement 3-10 

restore pacing 3-9 

return to ENTER TERMINAL TYPE 
message 3-10 

reverse ENTER/NEWLINE keys 3-7 

reversing column and field tab keys 3-7 

set home line 3-5, 6-42 

set left margin 3-4, 6-42 

set mark 6-42 

suppress pacing 3-9 

terminal status reporting 6-43 

type-ahead capability 3-2 

zones mode 3-6 



3277 insert mode 3-8 

3278 insert mode 3-7 
list of functions provided 2-6 
special features 

alternate screen size support 3-1 
color terminals 3-3 

differences in character representation 3-1 
highlighted fields 3-2 
IBM 7171 2-3 

components 2-2 

general description 2-2, 2-3 
IBM3101 

See IBM Personal Computer running in 3101 Emu- 
lation Mode 

See IBM 3101 
IBM316X 

SeeIBM316X 
illustration of the front of the 7 1 7 1 8-8 
Inbound Transmissions 6-34 
indent 3-4 

Initial Status and Sense Conditions 6-30 
Insert Cursor (IC) Order 6-9 
installation 

planning 2-12 
installation Hints B-3 
Interface Codes 6-3 
Intervention Required 6-19 
Introduction C-2 
Introduction to the IBM 7171 1-1 
ISO 2110 5-1 



K 



keyboard arrangement 

alternate 3-10 

primary 3-10 
keyboard initiated line drop 
keyboard lock 3-13 
keyboard unlock 3-10 



3-9 







Lear Siegler ADM-3A 

control and cursor movement keys B-3 2 

installation hints B-3 6 

local reset and control functions B-3 6 

program function keys B-34 

setup functions B-3 5 
Lear Siegler ADM-31 

control and cursor movement keys B-27 

installation hints B-3 1 

local reset and control functions B-3 1 

program function keys B-29 

setup functions B-30 
line drop 3-9, 4-66 
line speed 2-3 
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local editing functions 2-4 
local reset and control facilities 
local reset and control functions 
lock 

See keyboard lock 



3-10 
B-3 



M 



maintaining the 7171 
master reset 3-10 
Memory mapped I/O 
Menu Driven Screens 
MVS line drop 4-65 
MVS operating system 



8-13 

9-3 
C-4 

2-3 



MVS terminal operation 2-14 



N 



1-3 



Native Terminal Types C-6 

new features 

alternate screen sizes 1- 
ignore input parity 1-3 
new supported terminals 
outbound pacing 1-3 
rubout and mult keys 1-3 
transparent write/read 1-3 
3286 emulation 1-3 

NL 6-25 

No Operation Command 6-18 

not symbol (-.) 3-1 

notational conventions B-3 

null processing 3-5 
restriction 2-10 

NV-RAM 2-4 



o 



operating 

environment 
operating system 
operation 2-14 
Operation Check 
Order Codes chart 
orders 6-3, 6-8 

programming an ASCII device transparently 

special order strings 6-38 

using setup functions 6-38 
Overview 1-1, C-2 



2-11 
2-3,2-11 

6-19 
-9 



6-38 







pacing 

enable 5-8 

restoring 3-9 

suppressing 3-9 
pacing start 3-11 
pacing stop 3-11 
parity selection 2-5,2-11 
Personal Computer Disk Operating System 1- 
power indicator does not light 8-12 
preparing MVS 2-14 
preparing VM/SP 2-13 
primary 

display of attributes 3-9 

keyboard arrangement 3-10 
Printer Support 6-23 
Printer WCC Byte definition 6-24 
Printers 

3286 emulation 2-9 
problem determination for IBM 7171 8-1 
Problem Determination Procedures 

intermittent errors 8-21 

no power light 8-12 

no ready light 8-13 
Program Tab (PT) Order 6-9 
protected data 3-12 
protocol conversion 1-1 



R 



RAM 2-4 

Read Buffer Command 6-11 

Read Modified Command 6-13 

Read Modified data stream 6-14 

Read State 6-35 

Read State Transitions chart 6-36 

ready indicator does not light 8-13 

Repeat to Address (RA) Order 6-10 

Repeat to Address (RA) Order formats 6-10 

requirements 

See terminal 
reset functions 

character error reset 3-10 

keyboard unlock 3-10 

master reset 3-10 

type-ahead purge 3-10 
Reset Matrix for keyboard actions 6-38 
resources 

operating environment 2-11 
restore pacing 3-9 
restrictions 

bit combinations on printers 2-10 

on transmission of nulls 2-10 
Retry State 6-36 
return to ENTER TERMINAL TYPE message 3-10 
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reverse column and field tab keys 3-7 
reverse ENTER/NEWLINE keys 3-7 
ROLM 3270 

local reset and control functions B-64 

program function keys B-62 

setup functions B-63 
Rolm 3270-CYPRESS 

See Rolm 3270 
ROLM 3270- JUNIPER 

control and cursor movement keys B-60, B-61 
ROM 2-4 

ROM Terminal Definitions C-6 
RS-232-C 5-1 

RS-232-C port numbering 8-9 
RS-232-C port numbering conversion chart 8-9 



E 



6-16 



3-7 



■10 



screen refresh 3-12 

Select RB Command 6-16 

Select RBP Command 6- 1 7 

Select Read Modified (RM) Command 

Select RMP Command 6-17 

Select WRITE Command 6- 1 7 

Sense Bit Description 6-19 

Sense Command 6-18 

Sense ID Command 6-19 

servicing the 7171 8-13 

Set Buffer Address (SBA) Order 6-8 

setup functions 3-3 

alphanumeric in numeric-only fields 

alternate display of attributes 3-9 

alternate keyboard arrangement 3 

APL mode off 3-8 

APL mode on 3-8 

ASCII input in APL mode 3-9 

Delete All Column Tabs, and Reset Home Line and 
Left Margin 3-5 

delete column tabs 3-4 

for host application programs 6-40 
multiple setup format 6-42 

improved null processing 3-5 

keyboard initiated line drop 3-9 

primary display of attributes 3-9 

primary keyboard arrangement 3 

restore column and field tab keys 

restore ENTER/NEWLINE keys 

restore pacing 3-9 

return to ENTER TERMINAL TYPE message 

reverse column and field tab keys 3-7 

reverse ENTER/NEWLINE keys 3-7 

set column tabs 3-4 

set home line 3-5 

set left margin 3-4 
3-9 



-10 

3-7 

3-7 



3-10 



suppress pacing 
using 6-38 
zones mode off 
zones mode on 



3-7 
3-6 



3270 numeric-only fields 3-7 

3277 insert mode 3-8 

3278 insert mode 3-7 
Short Read 6-15 

Start Field (SF) Order 6-8 

start-up 2-14 

Status Byte Bit Assignment 6-29 

Status Modifier 6-29 

Status/Sense bits 6-29 

string 

transparency 
write 6-38 
write/read 6-40 
support utility 1 -2, C- 1 , C-2 
Calling tree C-14 
Command Syntax C-100 
Compared to Series/ 1 IUP C-87 

EADSCSS C-87 

EADSLINE C-87 

EADSNODE C-87 

EADSTERM C-87 

TERMINAL DEVICE= C-87 

TERMTYPS C-87 
Configuring the Ports C- 1 5 
Continuation line example C-92 
Conversion of EDL to TML C-92 
Dial-up C-58 

DOS Batch File Example C- 1 02 
Entering a New TDT C- 1 6 
Hardware requirements C-12 
IBM 7171 Macro Language C-78 
Installation C-12 
MLNK Error Codes C-99 
Modifying a TDT C-17 
Objectives of C-2 
PRO PORT Macro C-82 

BAUD= C-82 

BIND= C-82 

FLAGS= C-82 

LIST= C-82 

portno C-82 
Pseudo ops C-89 
ROM Defined Names C-92 
Series/ 1 IUP C-78 
Syntax restrictions C-89 

Comments C-92 

Continuation Lines C-92 

Valid ASCII Mnemonics C-93 

Valid Macro Names C-93 
TML CSS Macro C-86 

Continuation C-86 

EQU C-86 
TML Syntax Templates C-79 
TML TERM Macro C-84 

ALC= C-85 

ALR= C-85 



3270 null processing 3-6 



APC= C 
APR= C- 
DELAY= 
DLC= C 
DLR= C 
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85 
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•84 
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DPC= C-85 

DPR= C-85 

FLAGS= C-85 

HTRAN= C-84 

inputtab C-84 

ORIGIN= C-84 

RCHRS= C-84 

SGR= C-85 

TTRAN= C-84 
TML TERMTYPS Macro C-83 
Updating the Ports Image C-16 
Upload / Download C-57 
7171 Edit .CTL C-50 
7171 Edit .CTL Edit C-53 
7171 Edit .CTL Load C-52 
7171 Edit .CTL Save C-54 
7171 Error Messages C-67 
7171 from menus C-18 
7171 I/O C-57 
7171 Link C-55 
7171 Main Menu C-20 
7171 Ports Configure C-25 
7171 Ports Load C-24 
7171 Ports Menu C-22 
7171 Ports Report C-29 
7171 Ports Save C-28 
7171 Terms Edit C-34 
7171 Terms Load .TRM C-33 
7171 Terms Menu C-31 
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